codereview

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:

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:

┌─────────────────────────────────────────────────────────────┐
│                       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

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

Manually

Claude Code

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.

Codex CLI

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

Skill	Description	Use When
retrieve-diff-from-github-pr	Fetch PR diff and metadata via GitHub API	Reviewing GitHub PRs
retrieve-diff-from-commit	Get diff from local git commits	Reviewing local changes

🎯 Orchestrator

Skill	Description	Use When
codereview-orchestrator	Triage, assess risk, route to specialists. Coordinates full pipeline.	Entry point for all reviews

🔍 Specialists

Skill	Modeled After	Focus Area	Trigger
codereview-security	Cursor BugBot	Vulnerabilities, auth, injection, secrets	Auth, input, API calls
codereview-correctness	-	Logic bugs, error handling, edge cases	Core business logic
codereview-api	-	Contracts, breaking changes, versioning	Routes, endpoints, schemas
codereview-data	-	Migrations, queries, transactions	Database, models
codereview-concurrency	-	Retries, idempotency, distributed systems	Async, workers, queues
codereview-performance	-	O(n²), N+1, memory leaks, caching	Loops, queries, I/O
codereview-observability	-	Logging, metrics, tracing, alerting	Monitoring code
codereview-testing	-	Coverage, quality, determinism	Test files
codereview-style	-	Readability, maintainability, docs	All files (final pass)
codereview-config	-	Secrets, feature flags, environment	Config, env files
codereview-architect	Greptile	Blast radius, dependencies, patterns	Core utilities, shared libs

📤 Output Skills

Skill	Description	Use When
submit-github-review	Post review findings to GitHub PR via API	Submitting review to GitHub

📋 Methodology

Skill	Description
general-codereview	Google's classic 5-step methodology: Pre-screen → Understand → Verify → Optimize → Check

Recommended Workflow

One-Command Pipeline (GitHub PRs)

Review PR 123

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