Skip to content
SkillModel-led926 tokens in use

retro

Run a retrospective on a coding agent session and get ranked suggestions for improving its environment.

328,764 stars on the repository MIT Licensemattpocock/skills · skills/engineering/retro
claude plugin install mattpocock-skills@claude-plugins-official
View source

Install command as written in the repository's README

Skill label

measured from its files

What installing retro costs

12tokens idle
926tokens in use

Idle is what sits in context while the skill is installed. In use is its instructions, loaded when it runs. Counts are approximate, made offline with cl100k_base.

Model dependence Model-led

Script-ledMixedModel-led

Mostly instructions, so how well it works depends on the model that follows them.

This describes the skill's structure, how much of it is scripts. It does not say how well it works.

Touches

Nothing detected: no shell, network, file writes, git or credentials in its files.

Declared tags come from the skill's frontmatter; detected ones from its scripts and code blocks. This is detected, not audited.

How it scores

Quality

How well the skill is written, counted from its own files: its frontmatter, its steps, examples, stated output and constraints, its size and whether every file it ships is one it names.How we score it →
Fair
  • Frontmatter8/15
  • Structure23/25
  • Examples0/15
  • Output10/15
  • Size15/15
  • Resources0/15

Security

Starts at 100 and loses points for each thing in the skill's files that a reader should look at first.How we score it →
Excellent

No findings.

Repository health

Pre-computed score based on development activity, maintenance, community, maturity, and trend momentum.How we score it →
Excellent
  • Development activity96
  • Maintenance100
  • Community56
  • Maturity32
  • Momentum40

Retro reads the primary sources of a coding session, by default the current one, and looks for ways to improve the environment the agent works in. It checks seven areas: navigation, automated checks, coding standards, global AGENTS.md, tool economy, no-ops and information access. Candidates come back ordered by severity.

The skill is user-invoked and ends with a presentation of candidates for you to choose from.

What You Get

  • A ranked list of environment improvements drawn from a real session
  • Findings sorted into navigation, automated checks, coding standards, steering files, tool economy, no-ops and information access
  • A check of the repo’s own lint and CI setup before any new guardrail is proposed

Common Use Cases

  • Review a long session where the agent spent a lot of time finding the right files
  • Decide whether a repeated mistake needs a lint rule, a hook or a CI job
  • Trim an oversized CLAUDE.md or AGENTS.md after a session

What Makes It Unique

Retro aims the review at the environment the agent runs in. It separates mechanical violations, which get a deterministic check, from judgement calls, which go in CODING_STANDARDS.md. It also reasons about implementation and review as two stages with different context pressure, and gives the reviewer agent the job of enforcing standards.

Under The Hood

The skill is a single SKILL.md of instructions with no scripts. It first loads the writing-for-agents skill for style, then reads session logs on the local machine and the repo’s own check commands and CI workflow. It writes no files and runs no commands of its own; it returns a list to the user.

Join founders building with open source

Opinionated takes, migration guides, cost-saving tips, and insights from the open source ecosystem.

Subscribe on SubstackJoin 750+ subscribers