code-review

Code Review — Skill Entry

This SKILL.md is the entrypoint for the Code Review skill.

The skill provides a reusable review workflow for orchestrators and perspective subagents that evaluate code changes across functional, standards, accessibility, PR, security, readiness, and full review perspectives. It centralizes change-brief preparation, review depth selection, severity normalization, and output contract details so that review agents stay thin and consistent.

Shared principles

Review work should stay anchored in evidence and should avoid premature conclusions. Keep the review grounded in file and line evidence, use proportional depth based on risk, read the full diff range before narrowing, and keep factual orientation separate from structured findings.

Normative references

1. Output Formats — reporting structure, merged report skeleton, and persisted artifact contract.
2. Severity Taxonomy — severity levels, verdict normalization, and risk classification.
3. Lens Checklists — perspective-specific review questions for functional, standards, accessibility, PR, security, and readiness reviews.
4. Context Bootstrap — Tier 0 procedure for proving the change surface, drafting a change brief, and scoping hotspots.
5. Depth Tiers — basic, standard, and comprehensive verification rigor dials.
6. Walkthrough Protocol — firm orientation floor, full-diff reading contract, and Register 1 narrative guidance.
7. Dispatch Loop — human-steered dispatch board, manifest schema, and walk-back loop contract.
8. Emission Modes — capability-gated dual-mode emission and persisted emission record.
9. Cross-Skill Forks — specialist review registry and collection-aware gating for follow-up reviews.
10. Change-Risk Evidence Checklist — advisory evidence categories for selecting review depth with human confirmation.

Skill layout

• SKILL.md — this file (skill entrypoint).
• references/ — durable review knowledge documents.
  • output-formats.md — output schema, report skeleton, and persistence behavior.
  • severity-taxonomy.md — severity and verdict normalization model.
  • lens-checklists.md — per-perspective review checklists.
  • context-bootstrap.md — Tier 0 context bootstrap and human-scoping workflow.
  • depth-tiers.md — Tier 1/2/3 verification-depth guidance.
  • walkthrough-protocol.md — orientation-first walkthrough contract and Register 1 narrative expectations.
  • dispatch-loop.md — dispatch board, manifest schema, and walk-back loop.
  • emission-modes.md — native and canonical emission strategies.
  • cross-skill-forks.md — specialist review registry and gating rules.
  • change-risk-model.md — advisory evidence checklist for selecting review depth with human confirmation.