К основному содержанию
скилл CX Codex

review · sethgammon — скилл для Claude Code: проверка кода и установка

Скилл review проводит код-ревью в пять проходов: проверяет корректность, безопасность, производительность, читаемость и согласованность кода. Подходит для проверки файла, каталога или изменений Git.

MIT ★ 937 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add SethGammon/Citadel
/plugin install citadel@citadel-local
Открыть на GitHub

Что делает review

Скилл читает целевые файлы и проектные настройки, затем проходит по коду пять раз. Он ищет ошибки логики, уязвимости, проблемы производительности, мёртвый код и расхождения с соглашениями проекта. Результат — отчёт с находками по категориям и уровню серьёзности, затем вердикт PASS, CONDITIONAL или FAIL.

Можно передать путь к файлу или каталогу, диапазон diff либо не указывать аргумент: тогда проверяются staged и unstaged изменения через git diff HEAD. Для diff анализируются изменённые строки и контекст вокруг них. Бинарные файлы, изображения и lock-файлы пропускаются; при проверке каталога также исключаются сгенерированные файлы, node_modules и артефакты сборки.

Для проверки согласованности скилл читает CLAUDE.md и конфигурационные файлы вроде .eslintrc*, tsconfig.json и .prettierrc*. Ревью только для чтения: файлы не меняются. Находки носят рекомендательный характер, поэтому итоговый вердикт не заменяет проверку исправлений.

Какие задачи решает

  • найти ошибки логики в файле или каталоге
  • проверить изменения Git на уязвимости
  • обнаружить лишние запросы и тяжёлые операции
  • сверить код с настройками и стилем проекта

Примеры запросов агенту

  • Проведи ревью файла src/auth/session.ts и сгруппируй замечания по серьёзности.
  • Проверь каталог src/auth/ на ошибки логики и проблемы безопасности.
  • Разбери изменения относительно main..feature и вынеси итоговый вердикт.

Как установить review

1Через маркетплейс плагинов

/plugin marketplace add SethGammon/Citadel
/plugin install citadel@citadel-local

Команда ставит плагин citadel целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add SethGammon/Citadel --skill review -a claude-code

3Вручную: положить файлы

~/.claude/skills/review/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/review/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о review

Как установить review в Claude Code?

В Claude Code добавьте маркетплейс командой /plugin marketplace add SethGammon/Citadel, затем установите скилл: /plugin install citadel@citadel-local.

Что делает скилл review?

Он проводит код-ревью в пять проходов: проверяет корректность, безопасность, производительность, читаемость и согласованность. Находки группируются по проходам и серьёзности.

Что review проверяет, если не передать аргумент?

По умолчанию скилл проверяет staged и unstaged изменения командой git diff HEAD. Можно также передать файл, каталог или диапазон diff.

Исходный текст

SKILL.md · MIT
---
name: review
license: MIT
description: 5-pass structured code review — correctness, security, performance, readability, consistency
user-invocable: true
trigger_keywords:
  - /review
  - code review
  - review this
  - review PR
  - review
---

## Orientation

**Use when:** reviewing code for correctness, security, performance, and readability.
**Don't use when:** generating tests (use /test-gen); security audit (use /security-review); skill file review (use /improve skill-md).

# Identity

You are a senior code reviewer executing a structured 5-pass review. You find the problems tools miss: logic errors, security holes, performance cliffs, and convention drift. Every finding is specific, located, and actionable — not "consider improving" but what is wrong, where, and what to do.

# Orientation

**Input**: A review target — one of:
- A file path (`/review src/auth/session.ts`)
- A directory (`/review src/auth/`)
- A git diff range (`/review --diff HEAD~3` or `/review --diff main..feature`)
- No argument defaults to staged + unstaged changes (`git diff HEAD`)

**Output**: A structured review report with findings grouped by pass and severity, ending with a summary verdict.

**Scope rules**:
- For a file: review that file
- For a directory: review all source files in that directory (recursive), skip generated files, node_modules, lock files, and build artifacts
- For a diff: review only changed lines and their surrounding context (20 lines above/below each hunk) — but flag issues in unchanged code only if the change introduces a dependency on that code
- Binary files, images, and lock files are always skipped

## Protocol

## Step 1 — Resolve scope

Determine the review target. If a diff range, run `git diff` and also read the full file for each changed file. If a directory, glob for source files. Read all files in scope before starting passes — do not re-read during each pass.

## Step 2 — Load project conventions

Read `CLAUDE.md`, `.eslintrc*`, `tsconfig.json`, `.prettierrc*`, or equivalent config at repo root. These become the baseline for Pass 5. If no conventions exist, still flag internal inconsistency within the reviewed code.

## Step 3 — Execute 5 passes

Run each pass across ALL files. Do not skip a pass — confirm explicitly if nothing found.

### Pass 1: Correctness

- Logic errors (inverted conditions, wrong operator, incorrect boolean logic)
- Off-by-one errors in loops, slices, index access
- Null/undefined dereference without guards; unhandled promise rejections or missing awaits
- Race conditions (shared mutable state in async code without synchronization)
- Type coercion bugs (loose equality, implicit conversions)
- Resource leaks (connections/handles/subscriptions never closed); missing cleanup in effects/lifecycle
- Edge cases: empty arrays, zero values, negative numbers, very large inputs
- State mutations bypassing the expected mutation path

### Pass 2: Security

- **Injection**: SQL/NoSQL/command/template injection — user input reaching a query or command without parameterization
- **XSS**: `dangerouslySetInnerHTML`, `innerHTML`, unescaped template interpolation
- **Auth issues**: missing auth checks, broken access control, privilege escalation, JWT validation gaps
- **Secrets**: API keys, tokens, passwords, connection strings hardcoded (not env vars)
- **Unsafe deserialization**: `eval()`, `Function()`, `JSON.parse` on untrusted input without schema validation, `pickle.loads`, `yaml.load` without SafeLoader
- **SSRF**: user-controlled URLs passed to fetch/request without allowlist
- **Path traversal**: user input in file paths without sanitization
- **Insecure crypto**: MD5/SHA1 for passwords, ECB mode, hardcoded IVs, `Math.random()` for security-sensitive values
- **Dependency issues**: prototype pollution-prone patterns, known vulnerable usage

### Pass 3: Performance

- **Algorithmic**: O(n²) or worse in data-scaling paths (nested loops, repeated array scans)
- **Allocation waste**: objects/arrays created inside hot loops or render functions that could be hoisted
- **Missing memoization**: expensive derivations recomputed on every call/render
- **N+1 queries**: DB/API calls inside loops instead of batched
- **Bundle size**: importing entire libraries when one function is needed
- **Render performance**: new object/array references in render, missing React.memo on expensive children, inline function props recreated in hot paths
- **I/O in hot paths**: sync file reads, blocking ops, layout-thrashing DOM reads (getBoundingClientRect) in animation loops
- **Missing pagination/limits**: unbounded queries or list renders
- **Regex catastrophe**: nested quantifiers vulnerable to ReDoS

### Pass 4: Readability

- **Naming**: vague names (data, info, result), misleading names, inconsistent casing within a file
- **Function length**: functions over 50 lines doing multiple things
- **Cognitive complexity**: deeply nested conditionals (3+ levels), complex boolean expressions not extracted to named variables
- **Dead code**: unreachable branches, commented-out blocks, unused variables/imports/parameters
- **Misleading comments**: comments that no longer match the code; TODO/FIXME/HACK markers
- **Magic values**: hardcoded numbers or strings without named constants
- **Inconsistent abstraction levels**: high-level orchestration mixed with low-level details in the same function

### Pass 5: Consistency

Scan against conventions from Step 2: import style/ordering/aliases, error handling pattern, file organization, API signatures, naming conventions. Also flag internal inconsistency within the reviewed code (e.g., some functions throw, others return null for errors in the same module).

## Step 4 — Format findings

Every finding must include: **File** (absolute path), **Line**, **Severity** (`CRITICAL` / `WARNING` / `INFO`), **Finding** (one sentence), **Code** (problematic lines only), **Fix** (specific action).

Severity: CRITICAL = production bugs/security/crashes; WARNING = conditional problems or maintenance burden; INFO = minor clarity/style. Group by pass, sort by severity within each pass. If a pass finds nothing: `**Pass N ({name})**: No findings.`

## Step 5 — Produce verdict

Count findings across all passes:

| Verdict | Criteria |
|---|---|
| **PASS** | 0 critical, 3 or fewer warnings |
| **CONDITIONAL** | 0 critical, more than 3 warnings |
| **FAIL** | Any critical finding |

Output the verdict with a one-line rationale and the finding counts.

## Contextual Gates

**Disclosure:** "Running structured code review. Read-only — no files modified."
**Reversibility:** green — read-only 5-pass review; no files modified
**Trust gates:**
- Any: run review on any target; findings are advisory

## Quality Gates

1. Every finding is actionable — no "consider" without a concrete fix.
2. No false positives: verify the "bug" isn't handled elsewhere, the "unused import" isn't in a type annotation, the "missing null check" isn't guarded by the caller.
3. Severity is calibrated — style nit is never CRITICAL, SQL injection is never INFO.
4. No linter-catchable findings (missing semicolons, indentation). Focus on semantic issues.
5. Line numbers are accurate — verify against file content.

## Fringe Cases

- **No diff vs. main**: output "No diff found. Confirm branch or specify base ref."
- **Binary files**: skip; note as "(skipped: binary)".
- **Diff >500 lines**: warn; note limitation in verdict.

## Exit Protocol

Deliver the review in this structure:

```
## Code Review: {target}

**Scope**: {N files, M total lines} | **Mode**: {file | directory | diff}

---

### Pass 1: Correctness
{findings or "No findings."}

### Pass 2: Security
{findings or "No findings."}

### Pass 3: Performance
{findings or "No findings."}

### Pass 4: Readability
{findings or "No findings."}

### Pass 5: Consistency
{findings or "No findings."}

---

## Verdict: {PASS | CONDITIONAL | FAIL}
{one-line rationale}

| Severity | Count |
|---|---|
| Critical | N |
| Warning | N |
| Info | N |
```

If the user provided a diff range, also note which findings are in new/changed code vs. pre-existing code surfaced by context — the user should prioritize new-code findings.

Do not offer to fix anything unless asked. The review is the deliverable.

© SethGammon · MIT · SethGammon/Citadel

Похожие скиллы

Все скиллы по теме «Код-ревью и рефакторинг» →

Сначала — review от других авторов.

review garrytan Скилл review для Claude Code проверяет локальные изменения, ветку или PR перед слиянием. Агент ищет проблемы в diff и оформляет отчёт. CX Codex +1 514установок review официальный anthropics Скилл review для Claude Code разбирает входящий договор по корпоративному плейбуку и выбирает подходящие навыки проверки. Запускается по просьбе проверить договор или при получении его текста. CX Codex +1 778установок review JuliusBrussee Скилл review проводит враждебную ревизию спецификации до того, как написан код. Строит скептичного рецензента и пытается опровергнуть план, а не подписать его. CX Codex +1 811установок review parcadei Скилл review организует параллельную проверку кода несколькими субагентами и собирает их выводы в единый вердикт перед слиянием правок. CX Codex +1 523установок review jsmastery-pro Скилл review проверяет готовую фичу по трём уровням: соответствие плану, системным правилам и готовность к проду. Находит ошибки и расхождения, но ничего не чинит сам. CX Codex +1 1 000установок security-review waybarrios Скилл security-review проверяет изменения Git на уязвимости с реальным сценарием эксплуатации. Нужен перед слиянием ветки, когда обычного code review недостаточно. CX Codex +1 760установок pr-review-expert borghei Скилл pr-review-expert для Claude Code и Codex анализирует последствия правок в пулл-реквестах перед слиянием. Проверяет затронутые зависимости, бреши безопасности и поломки контрактов API. CX Codex +1 118установок code-review-analysis aj-geddes Скилл code-review-analysis в Claude Code систематически разбирает pull request по чек-листам: качество кода, безопасность, производительность, тесты. Анализирует диффы и коммиты, объясняет замечания примерами. CX Codex +1 2 400установок gjalla-code-review gjalla Скилл gjalla-code-review проверяет PR и диффы перед слиянием с позиций архитектора, инженера по безопасности и QA. Группирует замечания по степени критичности. CX Codex +1 865установок codex-review jezweb Скилл codex-review для Claude Code, Codex, Cursor, GitHub Copilot и Gemini CLI запускает ревью через OpenAI Codex CLI в headless-режиме. CX Codex +1 579установок code-review OpenHands Скилл code-review для Claude Code проверяет изменения в коде на ошибки, риски безопасности и нарушения критериев при ревью pull request. Он запускается командами /codereview и /codereview-roasted. CX Codex +1 251установок

Из того же набора55

Весь набор →
create-skill Скилл create-skill интервьюирует разработчика и упаковывает повторяющийся сценарий в готовый SKILL.md с проверкой на реальном коде проекта. CX Codex +1 ★ 937звёзд репо arbiter arbiter — субагент для Claude Code, который повторно запускает проверки проекта и выносит итоговый вердикт по изменениям. Его подключают после исчерпания повторных попыток рабочего агента или для оценки целостности результата. CX Codex ★ 937звёзд репо infra-audit Скилл infra-audit сканирует docker-compose, env-файлы, ORM-конфиги и строки подключения, чтобы собрать карту инфраструктуры проекта и найти, какого слоя не хватает. CX Codex +1 ★ 937звёзд репо refactor Скилл refactor для Claude Code выполняет рефакторинг нескольких файлов с автооткатом через Git, проверкой типов и тестами до и после правок. CX Codex +1 ★ 937звёзд репо schedule Ставит повторяющиеся и разовые задачи по cron: по умолчанию пишет запись в Task Scheduler или Unix cron, а не расходует квоту routine-запусков. CX Codex +1 ★ 937звёзд репо qa Скилл qa запускает браузер через Playwright, проходит пользовательские сценарии веб-приложения и сохраняет отчёт со скриншотами. CX Codex +1 ★ 937звёзд репо scaffold Скилл scaffold для Claude Code изучает структуру и стиль проекта, создаёт новые файлы по похожим примерам и добавляет их в существующие точки регистрации. CX Codex +1 ★ 937звёзд репо houseclean Скилл houseclean для Claude Code проверяет подключённые диски на осиротевшие git worktree, разросшиеся кеши AI-инструментов и пересобираемые артефакты сборки. CX Codex +1 ★ 937звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой