| name | readme-writer |
| description | Creates and writes professional README.md files for software projects. Use when the user asks to write a README, create documentation, or generate project docs from existing code or a description. |
| license | Apache-2.0 |
| metadata | {"author":"example-org","version":"1.0"} |
README Writer
Overview
Generate a complete, professional README.md and write it to disk. The output should be clear enough for a first-time contributor to understand the project, set it up locally, and start contributing.
Step 1: Gather Context
Look for project context before asking the user:
ls -la
cat package.json 2>/dev/null || cat pyproject.toml 2>/dev/null || cat go.mod 2>/dev/null
Step 2: README Structure
Every README must include:
- Project name and one-line description
- Badges (CI status, version, license)
- Features — bullet list of key capabilities
- Installation — exact commands to get running
- Usage — at least one real-world example
- Contributing — how to open a PR
- License