README Writer Skill

The README is a project's front door — most people decide in seconds whether to use or bounce. This skill writes a clear, scannable README that answers what is this, why should I care, how do I run it immediately, then layers in the detail. Structured so a newcomer gets to a working result fast.

Required Inputs

Ask for these only if they aren't already provided:

• Project name & one-line purpose — what it is and what problem it solves.
• Who it's for — the target user/developer.
• Install & basic usage — how to install and the simplest working example.
• Key features / differentiators — the few things that matter most.
• Project facts (optional) — language, license, links (docs, demo), contribution policy, status (alpha/stable).

Output Format

A complete README.md:

[Project name]

One-line pitch — what it does and for whom.

(Badges line — build, version, license — as placeholders to fill.)

Why [project]? — 2–3 sentences or bullets: the problem and what makes this worth using (honest, specific).

Features — the handful that matter, as a tight bullet list.

Quickstart

# install
# minimal working example

…with the expected result shown.

Usage — the common cases, with short code examples. Link out to full docs rather than inlining everything.

Installation — fuller install/requirements if the quickstart was minimal.

Contributing — how to contribute / link to CONTRIBUTING; be welcoming.

License — the license line.

(Adapt sections to the project; omit what doesn't apply. Keep it scannable with clear headings.)

Quality Checks

• Opens with a one-line pitch that says what it is and for whom