| name | code-review-playbook |
| license | MIT |
| compatibility | Claude Code 2.1.220+. |
| description | Structured review processes, conventional comments, language-specific checklists, and feedback templates. Use when reviewing PRs, conducting code review, or standardizing review practice. |
| version | 2.0.0 |
| author | OrchestKit |
| tags | ["code-review","quality","collaboration","best-practices"] |
| context | inherit |
| agent | code-quality-reviewer |
| user-invocable | false |
| hooks | {"PostToolUse":[{"matcher":"Write|Edit","command":"${CLAUDE_PLUGIN_ROOT}/hooks/bin/run-hook.mjs skill/pattern-consistency-enforcer"}]} |
| complexity | low |
| persuasion-type | discipline |
| effort | low |
| model | haiku |
| metadata | {"category":"document-asset-creation"} |
| allowed-tools | ["Read","Glob","Grep","WebFetch","WebSearch"] |
Code Review Playbook
This skill provides a comprehensive framework for effective code reviews that improve code quality, share knowledge, and foster collaboration. Whether you're a reviewer giving feedback or an author preparing code for review, this playbook ensures reviews are thorough, consistent, and constructive.
Overview
- Reviewing pull requests or merge requests
- Preparing code for review (self-review)
- Establishing code review standards for teams
- Training new developers on review best practices
- Resolving disagreements about code quality
- Improving review processes and efficiency
Upstream coverage (do not restate)
This skill is a thin wrapper. General review craft is documented first-party elsewhere;
only OrchestKit's own decisions live here. Load Read("${CLAUDE_PLUGIN_ROOT}/skills/code-review-playbook/references/ork-delta.md")
for the house rules that survived the retired files.
| Topic | Go here instead |
|---|
| Review philosophy, speed, tone, PR sizing | https://google.github.io/eng-practices/review/ |
| Conventional comment labels and decorations | references/conventional-comments.md, https://conventionalcomments.org/ |
| OWASP Top 10 review checks | rules/security-baseline.md, https://owasp.org/Top10/ |
| Generic language and framework review checklists | rules/typescript-quality.md, rules/python-quality.md, rules/linting-biome-rules.md |
| Review report shape and multi-agent full-PR review | ork:review-pr |
| Applying findings to the working tree | /code-review --fix, /simplify (see below) |
| Security-only pass over the current branch | /security-review |
| GitHub review mechanics (approve, request changes, inline comments) | https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests |
