retro

A Claude Code skill that mines your own session history to find what you keep tripping on — ranked by what it costs you, not by how often it happens.

Every conversation you have with Claude Code gets written to disk: every command, every error, every dead end. Nobody ever reads it. retro points Claude at that folder and asks one question — what do we keep tripping on? — then turns the top answers into things worth building.

It isn't introspection. Inside a single session there's no way to tell "I figured this out" from "I figured this out for the ninth time" — that's exactly the information one session lacks. So it doesn't ask. It reads the receipts.

Install

In Claude Code:

/plugin marketplace add voglster/retro
/plugin install retro@retro

Or from your shell:

claude plugin marketplace add voglster/retro
claude plugin install retro@retro

Then run /retro.

Manual install, if you'd rather not add a marketplace

mkdir -p ~/.claude/skills/retro
curl -o ~/.claude/skills/retro/SKILL.md \
  https://raw.githubusercontent.com/voglster/retro/main/skills/retro/SKILL.md

Using it

Run /retro on a project with real session history behind it. It needs a corpus — below about 10 sessions, or when nothing recurs across at least 3 different sessions, it will tell you so and stop rather than rank noise.

It's periodic, not per-turn. Run it after a big chunk of work or every few weeks.

Contents

• skills/retro/SKILL.md — the skill itself
• TALK.md — a 5-minute talk about it, and why measuring beats guessing
• Slide — one slide, if you want to give the talk too

License

MIT — see LICENSE.