BeClaude

codereview

New
7Community RegistryGeneralby Zainan Victor Zhou

Claude Skills for Code Review

Community PluginView Source

Overview

Agent Skills for Code Review.

These skills follow the Agent Skills specification so they can be used by any skills-compatible agent, including Claude Code and Codex CLI.

Quick Start

Review a GitHub PR with a single command:

code
Review PR 123
Review PR owner/repo#123  
Review PR https://github.com/owner/repo/pull/123

This will automatically:

  1. Fetch the PR diff from GitHub
  2. Triage and assess risk
  3. Run appropriate specialist reviews
  4. Post the review to GitHub

Overview

This plugin provides a comprehensive code review system modeled after industry-leading tools like CodeRabbit, Cursor BugBot, and Greptile. It uses an Input → Orchestrator → Specialists → Output pipeline architecture:

code
┌─────────────────────────────────────────────────────────────┐
│                       INPUT SKILLS                           │
│   retrieve-diff-from-github-pr  │  retrieve-diff-from-commit │
└────────────────────────────────┬────────────────────────────┘
                                 │
                                 ▼
┌─────────────────────────────────────────────────────────────┐
│                  codereview-orchestrator                     │
│                (Triage & Route - nothing else)               │
└──────────────────────────┬──────────────────────────────────┘
                           │
     ┌───────┬───────┬─────┴─────┬───────┬───────┬───────┐
     ▼       ▼       ▼           ▼       ▼       ▼       ▼
┌─────────┐ ┌─────┐ ┌─────┐ ┌─────────┐ ┌─────┐ ┌─────┐ ┌─────┐
│security │ │ api │ │data │ │concurr. │ │perf │ │test │ │style│
└─────────┘ └─────┘ └─────┘ └─────────┘ └─────┘ └─────┘ └─────┘
                           │
                           ▼
┌─────────────────────────────────────────────────────────────┐
│                       OUTPUT SKILLS                          │
│                    submit-github-review                      │
└─────────────────────────────────────────────────────────────┘

Installation

Marketplace

code
/plugin marketplace add xinbenlv/codereview-skills
/plugin install codereview@codereview-skills

Manually

Add the contents of this repo to a /.claude folder in your project root (or whichever folder you're using with Claude Code). See more in the official Claude Skills documentation.

Copy the skills/ directory into your Codex skills path (typically ~/.codex/skills). See the Agent Skills specification for the standard skill format.

Skills

📥 Input Skills

SkillDescriptionUse When
retrieve-diff-from-github-prFetch PR diff and metadata via GitHub APIReviewing GitHub PRs
retrieve-diff-from-commitGet diff from local git commitsReviewing local changes

🎯 Orchestrator

SkillDescriptionUse When
codereview-orchestratorTriage, assess risk, route to specialists. Coordinates full pipeline.Entry point for all reviews

🔍 Specialists

SkillModeled AfterFocus AreaTrigger
codereview-securityCursor BugBotVulnerabilities, auth, injection, secretsAuth, input, API calls
codereview-correctness-Logic bugs, error handling, edge casesCore business logic
codereview-api-Contracts, breaking changes, versioningRoutes, endpoints, schemas
codereview-data-Migrations, queries, transactionsDatabase, models
codereview-concurrency-Retries, idempotency, distributed systemsAsync, workers, queues
codereview-performance-O(n²), N+1, memory leaks, cachingLoops, queries, I/O
codereview-observability-Logging, metrics, tracing, alertingMonitoring code
codereview-testing-Coverage, quality, determinismTest files
codereview-style-Readability, maintainability, docsAll files (final pass)
codereview-config-Secrets, feature flags, environmentConfig, env files
codereview-architectGreptileBlast radius, dependencies, patternsCore utilities, shared libs

📤 Output Skills

SkillDescriptionUse When
submit-github-reviewPost review findings to GitHub PR via APISubmitting review to GitHub

📋 Methodology

SkillDescription
general-codereviewGoogle's classic 5-step methodology: Pre-screen → Understand → Verify → Optimize → Check

Recommended Workflow

One-Command Pipeline (GitHub PRs)

code
Review PR 123

This single command runs the full pipeline: fetch → triage → review → submit.

Quick Review (Local)

code
1. retrieve-diff-from-commit  → Get local diff
2. codereview-orchestrator    → Triage & route
3. Run recommended specialists in order

Comprehensive Review

code
1. retrieve-diff-from-github-pr  → Fetch PR diff
2. codereview-orchestrator       → Triage and generate plan
3. codereview-security           → Security issues
4. codereview-correctness        → Logic bugs
5. codereview-api                → Contract changes
6. codereview-data               → Database safety
7. codereview-concurrency        → Distributed concerns
8. codereview-performance        → Optimization
9. codereview-testing            → Test coverage
10. codereview-style             → Final cleanup
11. submit-github-review         → Post review to GitHub

Finding Schema

All specialist skills output findings in a consistent format:

json
{
  "severity": "blocker|major|minor|nit",
  "category": "security|correctness|performance|...",
  "evidence": {
    "file": "path/to/file.ts",
    "line": 42,
    "snippet": "problematic code"
  },
  "impact": "What breaks or what's the risk",
  "fix": "Suggested change",
  "test": "What test would catch this"
}

Feature Matrix

Pipeline Skills

FeatureGitHub PR InputCommit InputGitHub Submit
Fetch PR via API✅
Get Local Diff✅
Post Review✅
Inline Comments✅
Approve/Request Changes✅

Review Skills

FeatureOrchestratorSecurityCorrectAPIDataConcurPerfObserveTestStyleConfig
PR Summary✅
Risk Assessment✅
Specialist Routing✅
SQL Injection✅
XSS/SSRF✅
Auth Bypass✅
Secret Detection✅
Logic Bugs✅
Error Handling✅
Edge Cases✅
Breaking Changes✅
API Versioning✅
Migration Safety✅
Query Performance✅
Transaction Safety✅
Retry Logic✅
Idempotency✅
Race Conditions✅
N+1 Detection✅
Memory Leaks✅
Caching✅
Logging Quality✅
Metrics Coverage✅
Tracing✅
Test Coverage✅
Flaky Tests✅
Code Readability✅
Documentation✅
Secret Management✅
Feature Flags✅

Comparison with Industry Tools

FeatureThis PluginCodeRabbitBugBotGreptile
PR Summary✅✅
Interactive Chat❌✅
Security Analysis✅✅✅
Deep Context✅✅
Auto-fix Patches⚠️ Manual✅
Low False Positives✅✅
Self-hosted✅
Customizable✅
GitHub API Integration✅✅✅✅
One-command Pipeline✅✅
Local Commit Review✅

License

MIT

Author

Zainan Victor Zhou

Based on "5 steps to perform code reviews at Google" (2013) and modern code review tools like CodeRabbit, Cursor BugBot, and Greptile.

Install & Usage

1
Create the skills directory
mkdir -p .claude/skills
2
Download the skill file
mkdir -p .claude/skills && curl -o .claude/skills/codereview.md https://raw.githubusercontent.com/xinbenlv/codereview-skills/main/SKILL.md
3
Invoke in Claude Code
/codereview
View source on GitHub
code-review

Frequently Asked Questions

What is codereview?

Claude Skills for Code Review

How to install codereview?

To install codereview, create the .claude/skills directory in your project, then run the curl command to download the skill file. Once installed, invoke it in Claude Code with /codereview.

What is codereview best for?

codereview is a community categorized under General. It is designed for: code-review. Created by Zainan Victor Zhou.