review: Check a Diff Against Standards and Spec
Install this skill:
npx skills add mattpocock/skills skill=review -y -g
Source: mattpocock/skills/review
What it does
/review checks a diff along two separate axes:
- Standards: does the code follow this repo's documented conventions?
- Spec: does the code do what the issue, PRD, or plan asked for?
Keeping those axes separate matters. Code can follow every standard and still build the wrong thing. Code can satisfy the spec and still break the repo's conventions.
When to use it
Use /review when you want to inspect work since a fixed point.
That fixed point can be:
- a branch
- a commit
- a tag
- main
- another merge base
The skill asks what to review against if you do not provide it.
How it works
First, the skill pins the diff with a command like:
git diff main...HEAD
Then it finds the originating spec if one exists. It looks for issue references, PRDs, specs under docs, or a path you provide.
Then it gathers standards sources such as AGENTS.md, CONTEXT.md, ADRs, CONTRIBUTING.md, lint config, and style docs.
Finally, it runs two reviews in parallel and reports them side by side.
Why it is useful for agent work
Agent output needs two questions:
- Did it follow the instructions?
- Did it follow the repo?
/review keeps those questions from blurring together.
Pairs well with
- /to-issues, to create a clear spec before implementation
- /improve-codebase-architecture, when review reveals repeat architecture friction
- tdd, when a finding needs a regression test before the fix