review-walkthrough — скилл для Claude Code: разбор диффа по шагам
Собирает из диффа текущей ветки HTML-страницу с пошаговым разбором изменений и замечаниями по коду. Вызывается вручную, когда нужно пройти ревью глазами.
npx skills add trailofbits/skills --skill review-walkthrough -a claude-codeЧто делает review-walkthrough
Скилл берёт патч ветки и раскладывает его на шаги: связанные файлы в одну группу, определения раньше мест, где их используют, тесты рядом с тем, что они проверяют. Порядок коммитов при этом не важен — скилл сам выбирает, как читать удобнее. К каждому шагу идёт пояснение на 50–150 слов и список найденных проблем с уровнем серьёзности.
Базовую ветку скилл определяет так: сначала открытый PR, если метаданные доступны, иначе ветка по умолчанию из git symbolic-ref --quiet --short refs/remotes/origin/HEAD. main он не подставляет наугад — если база неоднозначна, спросит. Патч сохраняется во временный файл вне репозитория, а рендер идёт через uv run --no-project {baseDir}/scripts/render_walkthrough.py. Значит, uv должен быть в системе: без него страница не соберётся.
Ревью остаётся только чтением. Скилл не запускает тесты проекта и не ставит зависимости, ветки не переключает. Незакоммиченные правки в разбор не попадают, о них он просто сообщит. Метаданные GitHub нужны лишь для экспорта комментариев: страница даёт скопировать команду gh api, но сама ничего не публикует.
Какие задачи решает
- разложить большой дифф на читаемые шаги
- объяснить назначение изменений по файлам
- найти проблемы в коде с уровнем серьёзности
- привязать замечание к конкретной строке диффа
- подготовить разбор ветки перед ревью коллеги
Примеры запросов агенту
- /review-walkthrough:review-walkthrough
- $review-walkthrough
- сделай walkthrough по текущей ветке, база — ветка релиза
Как установить review-walkthrough
1Через Skills CLI (Vercel)
npx skills add trailofbits/skills --skill review-walkthrough -a claude-code2Вручную: положить файлы
~/.claude/skills/review-walkthrough/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/review-walkthrough/
1Через Skills CLI (Vercel)
npx skills add trailofbits/skills --skill review-walkthrough -a codex2Вручную: положить файлы
.agents/skills/review-walkthrough/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add trailofbits/skills --skill review-walkthrough -a cursor2Вручную: положить файлы
.cursor/skills/review-walkthrough/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install trailofbits/skills review-walkthrough2Вручную: положить файлы
.github/skills/review-walkthrough/SKILL.md1Через Skills CLI (Vercel)
npx skills add trailofbits/skills --skill review-walkthrough -a gemini-cli2Командой платформы
gemini skills install https://github.com/trailofbits/skills --path plugins/review-walkthrough/skills/review-walkthroughВручную: положить файлы
.devin/skills/review-walkthrough/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add trailofbits/skills --skill review-walkthrough -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о review-walkthrough
Как установить review-walkthrough в Claude?
Через установщик скиллов: npx skills add trailofbits/skills --skill review-walkthrough -a claude-code. После этого файл скилла лежит в ~/.claude/skills/review-walkthrough/SKILL.md.
Что делает review-walkthrough?
Собирает патч текущей ветки, делит его на логические шаги с пояснениями и списком замечаний, затем рендерит самодостаточную HTML-страницу для ревью.
Как его вызвать?
В Claude — /review-walkthrough:review-walkthrough, в Codex — $review-walkthrough. Скилл не запускается сам, только по явному вызову.
