| name | code-review-hardening |
| description | Use this skill for rigorous, structured code review with a self-repair loop. Applies change-type-aware strategies (feat, fix, hotfix, refactor, migrate, docs). Findings are severity-classified, then auto-fixed where possible. Triggers on PR reviews, code review requests, or when reviewing any change set. |
Code Review Hardening
Strengthen code against defects through systematic, type-aware review.
Every reviewed line is understood or explicitly scoped-out. Findings are
classified by severity and fixability. The agent applies direct fixes
autonomously and re-reviews before producing a final report.
Gotchas
Passive review is incomplete: A static report is a human review.
For an autonomous agent, after classifying findings the skill must
enter the self-repair loop — apply fixes, re-review, iterate.
Wrong strategy for the type: A hotfix and a new feature require
opposite postures. Applying a full-scope feat review to a hotfix
causes unnecessary delay. Always determine the change type first.
Blocking on style preference: Only block on style if the project's
style guide explicitly requires it. Personal style preferences are
Nit: — never gates.
Skipping lines: Every human-written line must be understood or
explicitly scoped-out with a note.
Mentoring vs. blocking: Label every educational comment
Mentoring: so the author knows it is not a gate.
Over-engineering: Block implementations that solve future problems
the author doesn't know they'll face. Solve today's problem well.
Quick Start
Input: Files or directories to review, optional change type tag
(feat | fix | hotfix | refactor | migrate | docs)
Output: Structured markdown review report with fix status
Workflow:
1. Determine change type (auto-detect or explicit)
2. Gather project context (style guide, conventions, docs)
3. Review per type strategy — read every line
4. Classify findings by severity AND fixability
5. Self-repair loop — apply direct fixes, re-review (max 3 passes)
6. Author review — remaining author-required items
7. Final verdict + escalation if needed
