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:
- Fetch the PR diff from GitHub
- Triage and assess risk
- Run appropriate specialist reviews
- 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.
