About deep-review
deep-review extends the `/review-diff` skill with additional review lenses. It is for reviewing change sets across relevant themes; it requires `review-diff` and stops if that skill is unavailable.
Key features
- 01Adds strong-tier standard review lenses
- 02Applies always-relevant cheap-tier themes
- 03Selects conditional themes from the diff
- 04Uses the review-diff flow for checks and reporting
Use cases
- 01Reviewing a change set across multiple themes
- 02Checking diffs for naming, style, and comments
- 03Adding focused checks for matching change types
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ anorth/ agent-skills --skill deep-reviewAfter installing, type/deep-reviewin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
themes/change-scope.mdarchitecture.mddependencies.mdconcurrency.mdapi-shape.mdcomments.mderrors.mdcoupling.mddeveloper-experience.mdinvariants.mdobservability.mdnaming.mdstyle.mdtests.mdDetails
From the project READMEDeep review
Run the /review-diff skill's flow with a bigger lens set.
If review-diff isn't available, tell the user and stop.
At its Lenses step, read the change set and decide which themes below are relevant. The lens set is:
review-diff's standard lenses, on thestrongtier, by their absolute paths inreview-diff's directory;- each theme under Always, and each theme under When the diff matches that fits the diff,
on the
cheaptier. Pass the theme file's absolute path as the lens.
Everything else follows review-diff: models, launch, check, triage, fix, and report.
Theme reviewers on the cheap tier are noisy, so the check step matters most for them.
Always
Naming— identifiersStyle— dead weight, constants, order, localityComments— comments, docs, stale nearby comments
When the diff matches
API Shape— public functions, types, endpoints, events, persisted formatsArchitecture— modules, layers, where state or effects liveChange Scope— mixed features, refactors, or cleanups in one PRConcurrency— shared mutable state, threads/coroutines, timersCoupling— module boundaries, wiring, cross-component APIsDependencies— manifests, lockfiles, vendored or generated code, new librariesCI locally— CI, build, lint, or codegen stepsErrors— new or changed failure paths, error types, panicsInvariants— validation, state transitions, persistence, aggregatesObservability— logs, metrics, journals, or swallowed failuresTests— tests, fixtures, doubles, or test helpers
Comments
Markdown supported