review

review

mattpocock ↓ 92k
Claude Code
View source ↗

What it does

  • Standards — does the code conform to this repo's documented coding standards?
  • Spec — does the code faithfully implement the originating issue / PRD / spec?
  • The repo overrides. A documented repo standard always wins; where it endorses something the baseline would flag, suppress the smell.
  • Mysterious Name — a function, variable, or type whose name doesn't reveal what it does or holds. → rename it; if no honest name comes, the design's murky.
  • Duplicated Code — the same logic shape appears in more than one hunk or file in the change. → extract the shared shape, call it from both.
  • Feature Envy — a method that reaches into another object's data more than its own. → move the method onto the data it envies.
  • Data Clumps — the same few fields or params keep travelling together (a type wanting to be born). → bundle them into one type, pass that.

Requirements & configuration

  • Speculative Generality — abstraction, parameters, or hooks added for needs the spec doesn't have. → delete it; inline back until a real need shows.

Configuration: HEADCODING_STANDARDSCONTRIBUTING

Derived from the skill's own SKILL.md documentation · extracted 2026-07-23

review

Source

Repository: https://github.com/mattpocock/skills

review FAQ

What does the review skill do?

Review the changes since a fixed point (commit, branch, tag, or merge-base) along two axes — Standards (does the code follow this repo's documented coding standards?) and Spec (does the code match what the originating issue/PRD asked for?). Runs both reviews in parallel sub-agents and reports them side by side. Use when the user wants to review a branch, a PR, work-in-progress changes, or asks to "review since X". Standards — does the code conform to this repo's documented coding standards? Spec — does the code faithfully implement the originating issue / PRD / spec?

What does review require?

Speculative Generality — abstraction, parameters, or hooks added for needs the spec doesn't have. → delete it; inline back until a real need shows. Configuration keys: HEAD, CODING_STANDARDS, CONTRIBUTING.

How do I install review?

Run: npx -y skills add https://github.com/mattpocock/skills --skill review --agent claude-code — the source lives at github.com/mattpocock/skills.

Maintain review?

Let people know it's listed here — add the badge (live metrics, light/dark aware) or a plain link to your README or docs.

review on getagentictools
[![review on getagentictools](https://getagentictools.com/badge/skills/mattpocock-skills-review.svg)](https://getagentictools.com/skills/mattpocock-skills-review?ref=badge)
npx agentictools info skills/mattpocock-skills-review

The second line is the CLI lookup for this page — handy in READMEs and docs.