What problem does it solve?
This Skill helps you create, update, and validate project README.md files so users can understand, install, run, and trust your project quickly—without guessing or digging through internal docs.
Core Features & Use Cases
- Project type detection: Detects common repo types (Python packages, web apps, Jekyll sites, and config/tools) and tailors the README accordingly.
- README template generation & updates: Produces a suitable README structure for the detected type and fills missing sections.
- Badge selection: Chooses appropriate Shields.io badges (including agentic workflow and uv expectations for Python).
- Section validation: Checks for essential sections (title/description, quick start, license, etc.) and enforces README quality constraints like badge count and end-user focus.
- Maintenance workflow: Keeps READMEs synchronized with project changes by guiding iterative review and validation.
Quick Start
Ask the Skill to update the README for your repository after you made changes, for example: update the README to match the current project structure and add the correct end-user quick start and badges.