Code Review Playbook

A comprehensive framework for conducting code reviews with conventional comments patterns, language-specific checklists, and structured review processes. Use it when reviewing PRs to standardize feedback (blocking vs. nitpick distinctions), training developers on review best practices, or establishing team review conventions. The playbook covers the full cycle: pre-review context checks, high-level then detailed review passes, security and testing checklists, and clear approval workflows. It complements Claude Code's built-in `/code-review` and `/code-review --fix` commands by providing the manual methodology and conventional comment syntax those commands reference. The discipline-focused approach helps teams move from ad-hoc commentary to structured, actionable feedback that distinguishes must-fix blocking issues from nice-to-have suggestions.

skills.sh installs: 254
GitHub stars: 301
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add yonatangross/orchestkit --skill code-review-playbook --agent claude-code

Installs into .claude/skills of the current project.

Files

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("references/ork-delta.md") for the house rules that survived the retired files.

SKILL.md on GitHub