Claude Code Skills: учим Claude вашим плейбукам

Claude Code skills — это сохранённые плейбуки: маленькие текстовые файлы, которые один раз учат Claude процедуре, чтобы вы больше никогда не вставляли одни и те же инструкции руками. Вы пишете файл SKILL.md, кладёте его в папку — и дальше Claude либо подгружает его сам, когда задача подходит, либо выполняет по команде /имя-скилла.

Я представляю скилл как карточку с рецептом, приклеенную внутри кухонного шкафа. Она не валяется на столе (в вашем контекстном окне) весь день — её достают только когда готовят именно это блюдо. Это самая важная деталь гайда: скилл почти ничего не стоит, пока им не пользуются, поэтому можно собрать целую библиотеку skills для Claude и не замедлить его ни на грамм. И не нужен никакой marketplace для старта: первый скилл — это пять строк текста.

Claude Code skills — что это такое технически?

Скилл — это папка, внутри которой лежит один файл SKILL.md. У файла две части. Сверху — короткая шапка (она называется frontmatter) между двумя маркерами ---, которая объясняет Claude, когда скилл уместен. Ниже — обычные инструкции человеческим языком. Имя папки становится командой: файл ~/.claude/skills/weekly-report/SKILL.md даёт команду /weekly-report. Личные скиллы в ~/.claude/skills/ работают во всех ваших проектах, проектные в .claude/skills/ — только в одном проекте, а скиллы из плагинов получают префикс вида /имя-плагина:имя-скилла, чтобы имена никогда не конфликтовали.

Skills вообще работают в Claude Code?

Да, и это не хак, а штатная фича. В Claude Code даже встроены готовые скиллы — /code-review, /debug, /loop доступны в каждой сессии. Срабатывают скиллы двумя путями: Claude читает описания и подключает нужный сам, когда запрос совпадает, либо вы вызываете его напрямую — слэш плюс имя. И момент, который путает людей со старыми туториалами: кастомные слэш-команды объединили со скиллами. Файлы в .claude/commands/ продолжают работать, но папка скилла делает то же самое и добавляет бонусы: вспомогательные файлы и контроль над тем, кто вправе его запускать.

Как создать skill в Claude Code?

mkdir -p ~/.claude/skills/meeting-notes

---
description: Преврати сырые заметки со встречи в список
  действий. Использовать, когда пользователь вставляет
  заметки или просит выписать договорённости.
---
Из присланных заметок сделай:
1. Резюме в три строки
2. Список действий, у каждого — ответственный
3. Открытые вопросы, на которые никто не ответил

Какие skills добавить в Claude Code первыми?

Отложите подборки «best Claude Code skills» на неделю и покопайтесь в собственной истории чатов — с этим согласны и все skills best practices. Хорошие первые кандидаты: скилл вашего стиля письма (как вы звучите, какие слова под запретом), скилл форматирования отчётов или постов и /summarize-changes — пересказ изменений в проекте человеческим языком. Три усилителя, которые стоит знать. Первый: $ARGUMENTS позволяет скиллу принимать ввод — скилл /fix-issue со строкой «Исправь задачу $ARGUMENTS» внутри запускается как /fix-issue 123. Второй: disable-model-invocation: true в шапке означает, что запускать скилл можете только вы — Claude не вправе сделать это сам. Ровно то, что нужно для действий с последствиями, вроде публикации. Третий: allowed-tools заранее одобряет конкретные инструменты на время работы скилла, чтобы Claude не спрашивал разрешение на одну и ту же безопасную команду десять раз.

Почему skills делают Claude Code ещё сильнее?

Люди спрашивают, как сгенерировать побольше скиллов и почему Claude Code так хорош. Половина ответа — дисциплина контекста: он подгружает детали только по необходимости. Скиллы устроены так же: в памяти по умолчанию висит лишь короткое описание, полный плейбук загружается при вызове. Поэтому документация советует держать SKILL.md короче 500 строк, а длинные справочники выносить во вспомогательные файлы внутри папки скилла со ссылками из основного. Даже в официальных примерах целый скилл-визуализатор кодовой базы держит SKILL.md крошечным, а тяжёлую работу отдаёт приложенному скрипту.

Мета-ход напоследок. Скажи Claude: «Понаблюдай, что я прошу тебя делать раз за разом, и предложи три скилла с готовыми SKILL.md». Лучшая библиотека скиллов не скачивается с GitHub — она выпаривается из ваших собственных повторов.