AgentSkillsCN

readme-polish

改进 README 的清晰性和完整性。在初级开发者需要关于设置和使用文档的指导时使用。

SKILL.md
--- frontmatter
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.