repo-pitchlisted

Use when writing or fixing the one-line description a repo shows the world — a GitHub About box, a README's opening sentence, a package summary on PyPI or npm, a Show HN title, a plugin or extension listing — or when those have drifted apart and you want them to be one string again. Also for judging a draft one-liner before adopting it: what length actually fits each surface, why a list of features reads as a non-answer, and which style rules are real versus somebody's taste. Checks that a pitch is well formed; it does not score whether the project is appealing, and it does not write marketing copy.
TheodoreAD/agent-skills · ★ 0 · AI & Automation · score 75

Install: claude install-skill TheodoreAD/agent-skills

# The one line a stranger reads first A repo's short description is one string with several deploy targets, not several strings. [`standard-readme`](https://github.com/RichardLitt/standard-readme) has required exactly that since 2017 — the README's short description **must** match the package manager's `description` and GitHub's description — and almost nobody does it: of 17 well-known projects sampled, 4 matched README to GitHub; of 13, 5 matched GitHub to their registry. So the work is usually not writing a new pitch. It is finding the one you already have, deciding which wording wins, and putting it on every surface. Every number below is sourced in [`references/measurements.md`](references/measurements.md) — the two corpora and how they were drawn, the full distributions, the platform limits with the code each was read from, and the two negative results that bound what this skill may claim. ## What this skill reads, runs and writes - **Reads**: a README path you name; this repo's own `scripts/`. `drift` additionally reads a GitHub repo's description and a package's summary on PyPI or npm. - **Runs**: `gh repo view <repo> --json description`, under `drift` only. Nothing else shells out. - **Writes**: **nothing.** Every command prints; none edits a README, sets a description, or calls any write API. Applying a fix is your edit, or your `gh repo edit`, taken deliberately. - **Network**: `drift` only — `api.github.com` through `gh`, plus `pypi.org` or `registry.npmjs