---

name: readme-polish description: Improve a README for clarity and completeness. Use when a junior developer needs guidance on documenting setup and usage.

README Polish

Purpose

Improve a README for clarity and completeness.

Inputs to request

• Current README content.
• Setup prerequisites and runtime versions.
• Common failure modes or FAQs.

Workflow

1. Ensure install, run, and test steps are present and ordered.
2. Add required environment variables and configuration notes.
3. Clarify expected outputs and common troubleshooting tips.

Output

• Revised README section suggestions.
• Checklist of missing items.

Quality bar

• Keep instructions concise and copy-pasteable.
• Surface the most common pitfalls early.