Readme Polish

Improve a project's README for clarity, structure, and completeness without changing its meaning. Use when the user asks to clean up, polish, or improve a README or project documentation.

contextosai cb22265 1.3 KB Updated

File contents

README Polish

Improve an existing README's clarity and structure while preserving its intent.

Steps

  1. Read the current README in full before changing anything.
  2. Check that it answers the questions a new reader asks, in order:
    • What is this project and who is it for?
    • How do I install it?
    • How do I use it (a minimal, copy-pasteable example)?
    • How do I configure it?
    • How do I contribute / where do I get help?
  3. Restructure and tighten the prose. Do not invent features, commands, or claims that aren't supported by the project.

Suggested structure

# Project Name
One-line description.

## Installation
## Usage
## Configuration
## Contributing
## License

Guidelines

  • Preserve technical accuracy above all — when unsure whether a command or claim is correct, flag it for the user instead of guessing.
  • Prefer a short, working example over a long prose explanation.
  • Keep headings shallow and scannable; use code fences for all commands.
  • Don't pad. Every section should earn its place.

contextosai/skills/tree/main/skills/readme-polish commit cb22265523

Frequently asked questions

npx skillmds@latest add contextosai/readme-polish