Agent skill

readme-polish

Improve a README for clarity and completeness. Use when a junior developer needs guidance on documenting setup and usage.

Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/readme-polish

SKILL.md

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.

Expand your agent's capabilities with these related and highly-rated skills.

Didn't find tool you were looking for?

Be as detailed as possible for better results