Repo Glowup — Documentation skill for Claude Code

repo-glowup

A [Claude Skill](https://www.anthropic.com/news/skills) that audits your repo's first impression, rewrites your README, and drafts your launch posts — grounded in what's actually in your code, nothing invented.

[](https://github.com/erdalacundakonuk/repo-glowup/actions/workflows/ci.yml) [](LICENSE) [](https://www.anthropic.com/news/skills)

Most repos don't get ignored because the code is bad. They get ignored because a visitor can't tell what it does, whether it works, or whether it's alive, in the 10 seconds before they hit the back button. `repo-glowup` turns that into something fixable.

$ (inside Claude, with the skill installed)
> audit my repo and rewrite the readme if it needs it

Score: 14/25
  Clarity          2/5  — the pitch is buried after a 40-line badge wall
  Visual proof     1/5  — no screenshot, no GIF, no example output
  Instant trial    3/5  — install command works, but it's 60 lines down
  Trust signals    4/5  — LICENSE present, CI green, no CONTRIBUTING.md
  Launch readiness 4/5  — topics set, social preview missing

Top fixes (highest impact first):
  1. Move the one-liner above the badges — right now it's page 2
  2. Add a 15-second terminal GIF showing the actual payoff
  3. Set a social preview image (Settings → Social preview)

→ README.md rewritten. Diff below.

*(Real output shape from an actual run — see [`references/`](references/) for the full rubric behind these numbers.)*

What it actually does

1. Scans your repo for the objective, checkable stuff — README structure, images and whether they have alt text, badges, LICENSE, CONTRIBUTING, CI config, recent commit activity — using a bundled script, not vibes.
2. Scores it against five categories that map to what a first-time visitor