review-template

name	review-template
description	Code review output templates with format specifications and severity guidance. Use when generating code reviews. Provides the review structure and quality bar.
user-invocable	false

Code Review Template

This skill defines the output format, severity levels, and quality bar for code reviews.

Output Format

Reviews are saved to: .claude/agent-outputs/reviews/<YYYY-MM-DDTHHmmssZ>-<scope>-review.md

Document Structure

## Summary

**Scope**: [Files/modules reviewed]
**Verdict**: [APPROVE | NEEDS CHANGES | REJECT]
**Key Finding**: [One sentence - the most important thing the author needs to know]

## Critical Issues

[Issues that MUST be fixed before merge. Empty section = none found.]

### Issue 1: [Descriptive Title]

**Location**: `file.py:42`
**Problem**: [What's wrong - specific and factual]
**Impact**: [Why it matters - security, correctness, data loss, etc.]
**Fix**: [Concrete suggestion]

## Improvements

[Issues that SHOULD be addressed. Grouped by category.]

### Organization
- `file.py:15` - [Issue and suggestion]

### Design
-  - [Issue and suggestion]



[Minor style/preference items. Keep brief - one line each.]

  - [Issue]
  - [Issue]



[Clarifications needed before approval. Don't use for rhetorical questions.]

 [Specific question about intent or requirements]