Урок 3. Скилл для самопроверки

Конспект урока «Verification Skills» из бесплатного курса Anthropic Claude Code in Action. Оригинал урока: https://anthropic.skilljar.com/claude-code-in-action/486930

Это пересказ на русском, а не перевод. Права на курс принадлежат Anthropic.

Почему именно этот скилл стоит сделать первым

Скиллы вообще нужны, чтобы автоматизировать повторяющуюся работу. Урок про один конкретный случай — проверку собственной работы. Если делать только один скилл, делай этот.

Подумай, как ты обычно проверяешь результат. Попросил отрефакторить, Клод закончил — и дальше ты должен вспомнить, что надо перепроверить. Может, попросишь прогнать тесты. Может, сам прочитаешь диф. Слабое место здесь — «должен вспомнить». Пропустил один раз, и плохой код уехал дальше.

Скилл убирает эту зависимость от твоей памяти. Схема такая: ты просишь отрефакторить, Клод заканчивает, изменение попадает под описание скилла — и скилл срабатывает сам. Дальше он по одному и тому же маршруту:

1. Прогоняет тесты.
2. Читает диф.
3. Проверяет, что тесты не ослабили ради зелёного прогона.
4. Отчитывается «прошло / не прошло» и прикладывает доказательства.

Всё это без твоей просьбы. Запускает скилл его собственное описание, а дальше он каждый раз проходит одни и те же шаги.

Обрати внимание на третий пункт

Зелёные тесты — недостаточное доказательство. Тест можно втихую ослабить так, что он проходит при любом раскладе. Поэтому скилл читает диф и убеждается, что тесты не подкрутили.

Формулировка урока, которую стоит запомнить: «готово» — это не «код на вид правильный», а «проверки прогнаны, результат виден и назван явно».

Та же схема ложится на любую повторяющуюся процедуру команды: чек-лист релиза, рецепт миграции, проверка перед PR. Практическое правило: если ты дважды набрал одну и ту же многошаговую инструкцию — это скилл.

В папке скилла лежит не только инструкция

Скилл — это не одинокий skill.md, а папка вокруг него. Именно это делает скиллы сильными для проверок:

• Положи рядом reference.md с подробным материалом и сошлись на него из skill.md. Клод прочитает его, только если действительно понадобится такая глубина. Основной файл остаётся коротким.
• Клади в папку скрипты. Клод их выполняет, а не загружает их содержимое в контекст. То есть скилл может нести с собой собственный инструментарий — например, check.sh, который прогоняет все проверки.

Вывод: сам skill.md держи худым. Всё тяжёлое — длинные объяснения и исполняемые скрипты — выноси в соседние файлы. Основной файл говорит, что делать; соседние держат глубину и инструменты.

Где чему место: три поверхности для инструкций

Мест для инструкций уже три, и их легко перепутать. Быстрый способ не путаться:

Куда	Что туда
CLAUDE.md	договорённости, действующие всегда: правила именования, куда класть файлы
Скилл	процедуры и справочный материал под конкретный тип задач
Hook	правило, которое Клод не должен иметь возможности пропустить

Разница принципиальная: CLAUDE.md и скиллы — это инструкции, которым Клод следует, а hook — это код, который выполняется. Если пропуск правила недопустим, не оставляй его на усмотрение того, кто следует инструкциям.

Итог

Скилл — это папка с skill.md внутри: имя, описание-триггер и сама процедура. В контекст подгружаются только описания, пока скилл реально не понадобился, — поэтому упаковывать в скиллы все повторяющиеся процедуры ничего не стоит.

Начни с проверки. Сделай скилл, закоммить в .claude/skills проекта — и вся команда получает один и тот же приём. Работа у всех проверяется одинаково и автоматически, и никому не нужно об этом помнить.