Requesting Code Review

Dispatch a code-reviewer subagent to review implementations against plan or requirements.

41|27|Updated Oct 6, 2025
One-click install
npx skills add https://github.com/obra/clank --skill requesting-code-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Requesting Code Review
Source: https://github.com/obra/clank/tree/main/skills/collaboration/requesting-code-review
Command: npx skills add https://github.com/obra/clank --skill requesting-code-review

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Waiting for human code reviews can slow down development, and manual reviews might miss subtle issues. This skill automates the process of requesting a code review from a dedicated AI subagent, providing immediate, structured feedback against a plan or requirements, ensuring quality and accelerating iteration.

Core Features & Use Cases

  • Automated Subagent Dispatch: Dispatches a specialized code-reviewer subagent with the necessary context (code changes, plan, SHAs).
  • Structured Review Template: Uses a detailed template to guide the subagent's review across code quality, architecture, testing, and requirements.
  • Early Issue Detection: Integrates review checkpoints into workflows like subagent-driven development to catch issues before they compound.
  • Use Case: After completing a task in your development plan, you'll use this skill to trigger an AI code review. The subagent will analyze your changes against the plan and provide actionable feedback, allowing you to fix issues immediately.

Quick Start

Get Git SHAs for the changes

BASE_SHA=$(git rev-parse HEAD~1) HEAD_SHA=$(git rev-parse HEAD)

Dispatch code-reviewer subagent (example for Claude Code / AI environment)

Task("Code Review", { WHAT_WAS_IMPLEMENTED: "Verification and repair functions for conversation index", PLAN_OR_REQUIREMENTS: "Task 2 from docs/plans/deployment-plan.md", BASE_SHA: BASE_SHA, HEAD_SHA: HEAD_SHA, DESCRIPTION: "Added verifyIndex() and repairIndex() with 4 issue types" })

Frequently Asked Questions about Requesting Code Review

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate code reviews in my development workflow?

Automate code reviews by dispatching an AI subagent to analyze your code changes against a plan or requirements. The subagent evaluates quality, architecture, and testing, then produces a structured report with issues by severity and actionable recommendations, enabling faster iteration without waiting for human review.

When should I request a code review during development?

Request code review after completing tasks in subagent-driven development, after finishing major features, before merging to main, or when stuck or planning refactoring. Early checkpoints catch issues before they compound, reducing rework and accelerating your development cycle.

What information do I need to provide for an AI code review?

Provide the BASE_SHA and HEAD_SHA from git to identify your changes, a description of what was implemented, and the plan or requirements document your changes should satisfy. The subagent uses this context to evaluate your code against your stated goals and detect misalignments.

Can I integrate code review automation into a CI/CD pipeline?

Yes, dispatch the code-reviewer subagent as part of your development workflow after task completion or before merging. By capturing git SHAs and relevant plan documentation, you can automate review checkpoints at any stage and receive structured feedback without manual intervention.

What does the code review report include?

The subagent produces a detailed reviewer report covering code strengths, issues organized by severity, architectural concerns, testing gaps, compliance with requirements, and an overall assessment. Recommendations are actionable, allowing you to address feedback immediately and iterate faster.

Do I need to be familiar with git commands to use code review automation?

Basic git familiarity is helpful—you'll retrieve BASE_SHA and HEAD_SHA using standard commands like `git rev-parse HEAD` to identify your commit range. The skill handles dispatching the review; git knowledge focuses on capturing the change boundaries accurately.