メニュー
Structured review processes, conventional comments, language-specific checklists, and feedback templates. Use when reviewing PRs, conducting code review, or standardizing review practice.
デフォルトでは、最初にソースを確認する Prompt が選択されています。直接コマンドに切り替えるか、ローカルコピーをダウンロードすることもできます。
インストールを決める前に、SKILL.md と SkillsMP に表示されている付属ファイルをお読みください。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
直接コマンドでは確認用 Prompt が省略されます。実行前にソースを確認してください。
npx skills add https://github.com/yonatangross/orchestkit --skill code-review-playbookコマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。
ローカルで確認しますか？SkillsMP が現在取得できるファイルをダウンロードできます。
Chain patterns for multi-phase pipelines: MCP detection, handoff files, checkpoint-resume, worktree agents, CronCreate monitoring. Use when building or debugging a pipeline skill.
OrchestKit doctor for health diagnostics across manifest integrity, hook configuration, skill validation, agent frontmatter, MCP server connectivity, CC version compatibility, and permission rules. Reports issues with severity levels and auto-remediation suggestions. Validates component counts, detects orphaned entries, and checks CC version matrix compliance. Use when diagnosing plugin health, troubleshooting configuration issues, or running pre-release checks.
Inspects the OrchestKit telemetry pipeline for the current project — lists all known telemetry files with write counts, sizes, schema status, growth trend, and orphan detection. Use when verifying the observability pipeline is healthy, debugging a missing writer, or auditing which files have schema locks vs. which are drift-vulnerable. Read-only — never modifies telemetry files.
SKILL.md を表示中
| 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"] |
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.
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 |
issue [blocking]: Missing error handling for API call
If the API returns a 500 error, this will crash. Add try/catch.
security [blocking]: API endpoint is not authenticated
The /api/admin/users endpoint is missing auth middleware.
Load Read("${CLAUDE_PLUGIN_ROOT}/skills/code-review-playbook/references/conventional-comments.md") for the full format, labels (praise, nitpick, suggestion, issue, question, security, bug, breaking), decorations ([blocking], [non-blocking], [if-minor]), and examples.
Check Context:
Verify Automated Checks:
Set Aside Time:
Follow a Pattern:
High-Level Review (5-10 minutes)
Detailed Review (20-45 minutes)
Testing Considerations (5-10 minutes)
Documentation Check (5 minutes)
Provide Clear Decision:
Respond to Author:
For Reviewers:
For Authors:
This playbook is the manual framework; Claude Code ships built-in commands that automate parts of it:
/code-review — reviews the current diff for correctness bugs and reuse/simplification/efficiency cleanups./code-review --fix (CC 2.1.152+) — runs the review then applies the findings to your working tree (a bug-hunting review covering correctness plus reuse/simplification/efficiency)./code-review --comment — posts findings as inline PR comments./simplify — CC 2.1.154 changed this: it now runs a cleanup-only review (reuse, simplification, efficiency, altitude) and applies the fixes — it no longer invokes the full /code-review --fix bug-hunt. Reach for /simplify for tidy-ups, /code-review --fix for bug-finding-plus-fix.Use the built-ins for fast diff-scoped passes; use ork:review-pr for the multi-agent, full-PR review (security + testing + architecture).
Skill Version: 2.0.0 Last Updated: 2026-01-08 Maintained by: OrchestKit
ork:architecture-patterns - Enforce testing and architectural best practices during code reviework:security-patterns - Auth, input validation, and OWASP patterns to complement manual reviework:testing-unit - Unit testing patterns to verify during reviewEach category has individual rule files in rules/ loaded on-demand:
| Category | Rule | Impact | Key Pattern |
|---|---|---|---|
| TypeScript Quality | rules/typescript-quality.md | HIGH | No any, Zod validation, exhaustive switches, React 19 |
| Python Quality | rules/python-quality.md | HIGH | Pydantic v2, ruff, mypy strict, async timeouts |
| Security Baseline | rules/security-baseline.md | CRITICAL | No secrets, auth on endpoints, input validation |
| Linting | rules/linting-biome-setup.md | HIGH | Biome setup, ESLint migration, gradual adoption |
| Linting | rules/linting-biome-rules.md | HIGH | Biome config, type-aware rules, CI integration |
Total: 5 rules across 4 categories
scripts/review-pr.md - Dynamic PR review with auto-fetched GitHub data
/ork:review-pr [PR-number]gh)$ARGUMENTS and !command for live PR dataassets/pr-template.md - PR description template
There is deliberately no review-report template here; ork:review-pr owns that output
shape. See references/ork-delta.md.