README Creator

Write a README that reads as a shop window, not a wiki.

• IS: writing or rewriting README.md for the person deciding whether to use the project, with the project type driving which capability sections earn a place.
• IS NOT: auditing or polishing an existing README's prose, or a multi-page docs site (use docs-writing); AGENTS.md or CLAUDE.md agent-instruction files (use agents-md). A README that already covers the project and just needs polish is docs-writing, not a rewrite.

The reader

Someone arrived from a search result, a registry listing, or a profile page. They have about fifteen seconds and one question: is this worth my time? Every line either answers that or gets cut.

They are not a contributor. Nothing about the build pipeline, the workspace layout, the release process, or the coding standards helps them decide, so none of it belongs here.

Reference Files