Updated 1w ago
by tommy0103
better-readme-skill
Audit and rewrite your README so readers can bail fast — an Art of README agent skill
30 GitHub stars (30)
+30 in 8 days
| Period | New stars |
|---|---|
| Oct 11 | +7 |
| Oct 12 | +1 |
| Oct 13 | 0 |
| Oct 14 | +1 |
| Oct 15 | +2 |
| Oct 16 | 0 |
- 1 skill (1 skills found in its SKILL.md files)
- 1 forks (1 forks)
- 1w ago last update (Last updated 1w ago)
Install
Skills CLI
npx skills add tommy0103/better-readme-skill
Asks which agents to install it for. Add -g to install it for every project.
Claude Code
git clone https://github.com/tommy0103/better-readme-skillcp -r "better-readme-skill/skills/better-readme" ~/.claude/skills/
Copies the better-readme skill into ~/.claude/skills/ for every project (use .claude/skills/ for one project).
Plugin
/plugin marketplace add tommy0103/better-readme-skill
Run inside Claude Code if the repository ships a plugin marketplace, then pick plugins from /plugin.
Skills can run code on your machine — read the SKILL.md first.
What it does
In the author's own words, from each skill's SKILL.md.
-
better-readme
Audit and rewrite a project README against reader-funnel principles (noffle's "Art of README"). Use when the user asks to review, improve, rewrite, or translate a README, or asks whether their README is good — covers funnel ordering, moving maintainer content out, doc-shape tests pinned in CI, neutral multi-tool framing, idiomatic translations, and link/claim verification.
skills/better-readme/SKILL.md on GitHub (opens in a new tab)
No skill matches that filter.
Review before you install
A skill is a set of instructions and scripts your agent will follow, and it can run code on your machine. Read the SKILL.md and any scripts first — this listing is not a security review.