readme
Installation
SKILL.md
README
A README is the front door, not the house. Every choice follows from one question:
What does a stranger need on the first screen to decide to try this, and where do they go next?
Anything that doesn't answer it moves to a docs page or another markdown file, and the README links to it.
Pick the type
| Type | When | Length |
|---|---|---|
| Signpost | A docs site already exists | Under 250 words |
| Pitch and go (default) | Everything else | 300 to 800 words |
| Manual | Never write this by choice | - |