// Evaluate and polish README and documentation. Ensure accuracy, structure, runnable examples, then de-slopify.
| name | readme-revise |
| description | Evaluate and polish README and documentation. Ensure accuracy, structure, runnable examples, then de-slopify. |
Update the README and other documentation to reflect all recent changes to the project.
Before making changes, evaluate the current state:
After updating content, apply de-slopify rules:
Review the result, identify the single biggest improvement remaining, apply it, and repeat until the documentation is clean, accurate, and professional.
Based on Jeffrey Emanuel's README Reviser (@doodlestein)
Multi-model code review for gastown. Reviews GitHub PRs (by URL or number) or local branches (by branch name). Spawns parallel Claude, Codex, and (optionally) Gemini reviewers with specialized prompts optimized for regression prevention, then synthesizes findings into a single maintainer-grade decision report. Use --skip-gemini for dual-model mode when Gemini quota is exhausted. Invoke with /review-pr <pr-url|number|branch>.
Multi-pass code review: correctness, security, performance, and maintainability. Each finding gets severity, location, and suggestion.
Remove telltale AI writing patterns from documentation and text. Direct, concise prose without AI artifacts.
Structured brainstorming: generate 30 ideas, critically evaluate each, distill to the best 5 with actionable implementation plans.
Multi-phase planning process: understand, decompose, design, validate, then implement. No code until the plan is approved.
Design and implement an agent-optimized CLI interface for any project. JSON output, structured errors, exit codes, token-efficient.
