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 pull requests, branch diffs, and local changes across functional, standards, accessibility, security, and readiness perspectives. It separates the review target and profile from perspective and depth selection, and centralizes change-brief preparation, severity normalization, and output contracts so 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, 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 package-aware gating for follow-up reviews.
10. Review Targets and Profiles: target resolution, profile expansion, task serialization, and emission identity.
11. 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.
  • review-targets.md: review target, profile, and task-state rules.
  • change-risk-model.md — advisory evidence checklist for selecting review depth with human confirmation.