README Generator
Overview
Automatically analyzes a codebase and generates a comprehensive, professional README.md.
When to Use
- User asks to "generate a README", "create documentation", or "document this project"
- New project needs a README but none exists
- Existing README is outdated or incomplete
How It Works
Step 1: Analyze project structure
Run: dir /b /s /a:d (Windows) or find . -maxdepth 2 -type d (macOS/Linux)
Step 2: Detect project type
Check for: package.json (JS), setup.py/pyproject.toml (Python), Cargo.toml (Rust), go.mod (Go), pom.xml (Java)
Step 3: Generate README sections
- Project Title - from package.json name or directory name
- Badges - CI status, version, license, downloads
- One-liner Description
- Features - auto-detect from exports and main functions
- Installation - standard install for detected type
- Usage - realistic examples from source code
- API Reference - parse function signatures
- Contributing + License
Output Format
Write a complete README.md with all sections. Keep descriptions under 80 chars per line. Include real badges (shields.io) and actual code examples from the source.