readme-badgeslisted
Install: claude install-skill konradcinkusz/architecture-standards
# README badges
**Read [`references/README-BADGES.md`](references/README-BADGES.md) before applying any of this.**
That file is the standard; everything below it is a summary to help you decide
whether this skill applies and to check your work afterwards.
## What this standard covers
- Why badges at all
- The two zones
- The three badge families and when each is used
- The standard header row
- The footer block
- The rules
- Worked examples
## Why badges at all
A badge is a one-glance answer to a question a visitor would otherwise have to
click around for: is this licensed, is it maintained, is CI green, is there a
live deployment. Most badge images are *live queries* — the badge service
fetches the repo's real state at render time — which is exactly what makes
them worth having and exactly what makes a wrong one damaging: a broken or
stale badge tells the visitor the repo is unmaintained more loudly than no
badge would. Every rule below exists to keep the row truthful.
---
Generated from [`docs/guides/README-BADGES.md`](https://github.com/konradcinkusz/architecture-standards/blob/main/docs/guides/README-BADGES.md) by `scripts/build-marketplace.mjs`. Do not edit this file: change the source document, or its entry in `catalog/marketplace.catalog.json`, and re-run the generator.