Главное с Claude Code Skills - не поставить кучу лишних навыков. Соберите небольшую библиотеку под свои задачи и для каждого навыка проверьте: Claude его видит, вызывает и выдаёт нужный результат.
Даже список навыков расходует контекст: по умолчанию под него отведён 1% окна. Когда места не хватает, часть описаний исключается. Начните с небольшой задачи на своих файлах и заранее решите, как будете проверять ответ.
По факту это папка: что проверить в SKILL.md
Навык (скилл) - по факту папка с инструкцией: что делать, в каком порядке и как проверить результат.
my-skill/
SKILL.md
scripts/
references/
assets/Обязателен SKILL.md, остальные папки добавляют по задаче. Между --- в начале файла находятся метаданные для выбора навыка. В Claude Code эти поля необязательны, но description помогает автоматическому выбору. Сама инструкция загружается при использовании.
CLAUDE.md содержит постоянные указания проекта. В навык выносится порядок действий для конкретной задачи. Через плагин можно установить сразу набор навыков. Старые файлы .claude/commands/ продолжают работать; при совпадении имени приоритет у навыка.
Различия навыков, субагентов, MCP и плагинов разобрал в отдельной статье.
Например, у меня есть навык для написания сценария. Я говорю: «Запусти навык», даю тему и прошу написать сценарий. В инструкции для такой задачи нужно указать порядок действий и то, как проверить результат.
Агента для написания статей я отдаю бесплатно: выложил его в канале целиком. Внутри инструкция на русском. Забрать можно здесь.
Разборы навыков под свои задачи я выкладываю в канале:
Перед установкой любого навыка с GitHub проверяйте его сами
С обновлениями будьте осторожны: автора могут взломать, аккаунт увести, в репозиторий может прилететь зловред. Всё ставите под свою ответственность.
Перед копированием:
- Прочитайте
SKILL.mdцеликом: понятны ли действия и их назначение? - Просмотрите связанные программы, справочники и ресурсы, включая
scripts/. - Проверьте внешние обращения и зависимости: куда уходят данные, что скачивается и запускается?
- Проверьте, какие файлы навык читает и меняет. Прочитайте
allowed-tools: это предварительное разрешение перечисленным инструментам на время вызова. Поле не ограничивает весь доступный набор инструментов.
Непонятную или ненужную операцию не запускайте. Проверяйте файлы и зависимости навыков даже из репозитория Anthropic.
Первый запуск делайте в отдельном пробном репозитории без секретов. Чужие инструкции вслепую в рабочий проект не переносите. Пробный репозиторий полной изоляции не даёт.
Библиотека под свою задачу
Скопировать навык недостаточно. Нужно его адаптировать под свои данные, под свою задачу.
Выберите из таблицы навык под текущую работу. Папки здесь размещаются вручную, каждый результат нужно проверить на своих файлах.
| Задача | Тип | Источник | Место установки | Вызов | Образ результата |
|---|---|---|---|---|---|
| Разобрать изменения Git | Отдельный summarize-changes | Claude Code | ~/.claude/skills/summarize-changes/SKILL.md | /summarize-changes или What did I change? | Резюме изменений и риски |
| Извлечь поля PDF | Отдельный pdf | Anthropic | .claude/skills/pdf/ | /pdf с задачей и файлом | Поля, сверенные с PDF |
| Написать текст страницы | Отдельный copywriting | marketingskills | .claude/skills/copywriting/ | /copywriting с заданием и данными | Черновик без выдумок о продукте |
| Проверить интерфейс | Отдельный web-design-guidelines | Vercel | .claude/skills/web-design-guidelines/ | /web-design-guidelines с задачей; автовыбор - Review my UI | Замечания к готовому коду |
Для PDF, текста и интерфейса копируйте из источника папку целиком, со связанными файлами. Навык Vercel проверяет готовый интерфейс. Для создания дизайна с нуля он не предназначен.
Выбор навыков под маркетинговые задачи разобрал в отдельной статье.
| Область | Путь | Доступность |
|---|---|---|
| Личная | ~/.claude/skills/ | Ваши локальные проекты |
| Проектная | .claude/skills/ | Сессии этого репозитория |
Для Cowork и облачных сессий эту схему путей не переносите.
Вместо ручной копии pdf можно установить пакет document-skills. Выберите один способ, чтобы не дублировать навык.
Как установить навык и запустить его явно и по задаче
Возьмём summarize-changes из примера Claude Code. Он получает текущие изменения Git и выдаёт короткое резюме и риски. Каждое утверждение в ответе можно сверить с изменёнными строками.
Шаг 1. Подготовьте небольшое изменение в пробном репозитории
Нужен пробный Git-репозиторий с коммитом. Измените заголовок в уже отслеживаемом README, правку не фиксируйте коммитом.
Команда git diff HEAD не покажет новый неотслеживаемый файл. Выполните её в терминале и сохраните разницу для сверки ответа.
Шаг 2. Создайте папку и сохраните SKILL.md
В обычном терминале выполните:
mkdir -p ~/.claude/skills/summarize-changesОткройте в редакторе файл ~/.claude/skills/summarize-changes/SKILL.md и сохраните образец из документации:
---
description: Summarizes uncommitted changes and flags anything risky. Use when the user asks what changed, wants a commit message, or asks to review their diff.
---
## Current changes
!`git diff HEAD`
## Instructions
Summarize the changes above in two or three bullet points, then list any risks you notice such as missing error handling, hardcoded values, or tests that need updating. If the diff is empty, say there are no uncommitted changes.Первый --- должен стоять на первой строке. Имя команды здесь берётся из имени папки.
Шаг 3. Проверьте, какие данные получит навык
Строка с ! и git diff HEAD в обратных кавычках подставляет в инструкцию текущую разницу файлов. В чат её отдельно не вводят.
Образец просит 2-3 пункта резюме и риски. При пустой разнице - сообщение об отсутствии незакоммиченных изменений.
Шаг 4. Запустите явно и проверьте выбор по запросу
Запустите Claude Code из пробного репозитория. Внутри сессии спросите:
What skills are available?После проверки списка вызовите:
/summarize-changesЗатем в отдельной свежей сессии задайте естественный запрос без команды:
What did I change?Claude выбирает навык по description: что делать и для каких задач. Явный вызов ещё не подтверждает, что Claude выберет навык сам. Проверьте оба способа.
Если для pdf выбрали установку пакетом, внутри сессии Claude Code введите:
/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skillsВызов имеет форму /plugin-name:skill-name; точное имя проверьте в списке. Ручную копию уберите из библиотеки до установки пакета.
Обнаружен - вызван - результат принят: что именно проверять
Ключевое - как проверить результат: что должно быть в ответе и чего там быть не должно?
Для пробного изменения в README заранее задайте условия приёмки:
- Резюме правильно называет изменённый файл и смысл правки.
- Ответ не приписывает проекту изменений, которых нет в сохранённой разнице.
- Риски выделены отдельно и связаны с правкой. Если конкретных рисков не видно, это прямо сказано.
Проверьте 3 вещи:
Обнаружен. Имя видно в списке доступных навыков. Это ещё не означает, что Claude его использовал и правильно выполнил задачу.
Вызван. Для явного и автоматического вызова отдельно сохраните из журнала запись загрузки или использования навыка. Заявление модели «я применил» и пересказ описания не засчитываются. Без записи не отмечайте вызов как подтверждённый.
Результат принят. Сохраните ответ и сверьте с исходной разницей по каждому условию. Факт вызова эту проверку не заменяет.
Проверьте, не вызывается ли навык без надобности: в свежей сессии спросите «Что такое MCP-сервер?» Автовызова summarize-changes не ожидаем. Сверьте журнал.
Теперь сравните ответы с навыком и без него. Возьмите одинаковую разницу файлов и запрос What did I change? в свежих сессиях с той же версией клиента и моделью. В первой навык включён. Для второй выключите его через /skills, значение skillOverrides - off. Файлы не меняйте. Явная команда /summarize-changes для сессии без навыка не подходит.
Заполните журнал своими наблюдениями:
| Что сохранить | С навыком | Без навыка |
|---|---|---|
| Версия Claude Code и модель | Заполните | Те же |
| Источник и редакция навыка | Заполните | Выключен |
| Исходная разница и запрос | Сохраните | Те же |
| Обнаружение и запись вызова | Приложите записи | Проверьте отсутствие вызова |
| Ответ | Сохраните | Сохраните |
| Файл и смысл правки названы верно | Да / нет, фрагмент ответа | Да / нет, фрагмент ответа |
| Нет выдуманных изменений | Да / нет, сверка с исходником | Да / нет, сверка с исходником |
| Риски соответствуют правке | Да / нет, обоснование | Да / нет, обоснование |
Если выигрыша нет, установка сама по себе не делает навык полезным. Для других навыков из таблицы повторите проверку со своими файлами и условиями приёмки.
Если хотите собрать такой порядок работы для своего проекта с ИИ-агентами, посмотрите программу практикума СмыслоКода.
Много не надо. Навык для узкой задачи оставьте в проекте
Для каждого нужного навыка сохраните назначение, источник, способ установки, условия вызова и критерии проверки результата.
Ненужные личные и проектные навыки выключайте через /skills. Перенос в ~/.claude/skills/ список не разгружает. Плагинами управляйте через /plugin: skillOverrides на них не действует.
При совпадении имён личный навык перекрывает проектный, корпоративный - оба. У плагина своё пространство имён.
При обновлении старого marketingskills сверьте переименования:
page-croиform-croобъединены вcro.email-sequenceзаменён наemails.product-marketing-contextзаменён наproduct-marketing.
Старые папки могут остаться рядом с новыми. Просмотрите их перед повторной проверкой библиотеки.
Если доступен /skill-doctor, посмотрите отчёт о расходе контекста и использовании навыков. Нужны версия от v2.1.252 и получение служебных флагов. Через Remote Control отчёт недоступен. Вызов и результат проверяйте независимо от этой команды.
Кстати, я снял ролик «Приёмы Claude Code: голос, субагенты, рутины, скиллы и MCP», обязательно посмотрите.
В нём показываю навыки вместе с другими приёмами работы в Claude Code: голосовым вводом, субагентами, рутинами, MCP, CLAUDE.md, Hooks, планами и Git.
Навык есть, но Claude может его не выбрать: где искать причину
Claude заглядывает в папку навыков и смотрит описание, но иногда может не зацепить нужный навык. Найдите в таблице, на чём остановилась проверка.
| Состояние | Что проверить | Что сделать | Повторная проверка |
|---|---|---|---|
| Нет в доступных | Область, путь, SKILL.md, совпадения имён, видимость, YAML | Исправить найденный дефект; первый --- поставить на первую строку | Запросить список навыков |
| Есть, но не вызывается | description, запрос, флаги вызова, paths, рабочий каталог | Исправить условие выбора или настройку | Повторить явный и автоматический вызов |
| Вызывается, но ответ не принят | Входные файлы, инструкцию, зависимости, образ результата | Исправить то, что не прошло приёмку | Сверить ответ в свежей сессии |
При ошибке YAML инструкция может загрузиться с пустыми метаданными. На версии от v2.1.233 проверьте разметку: в обычном терминале выберите команду для проектной или личной папки соответственно.
claude plugin validate .claude/skills
claude plugin validate ~/.claude/skillsДля диагностики разбора используйте claude --debug.
Как обновить сам Claude Code, разобрал в отдельной статье.
disable-model-invocation: true запрещает автовыбор моделью. user-invocable: false запрещает пользовательский вызов и скрывает команду из меню. Явная команда эти настройки не отменяет. При заданном paths проверьте соответствие файлов рабочему каталогу.
Качество ответа одним изменением description не исправить. Если диалог был сжат, повторный вызов может восстановить полную инструкцию.
Изменения SKILL.md в уже отслеживаемых личной и проектной папках подхватываются без перезапуска. Если папки skills при старте не было, после её создания и последующих изменений в ней нужен /reload-skills. В режиме Bare это отслеживание не работает.
Для изменений в hooks/, .mcp.json, agents/, output-styles/ плагина нужен /reload-plugins.
Цикл обратной связи: вызвали, запустили, оценили результат. Сказали, что не так, обновили SKILL.md и проверили снова.
Вопросы и ответы
Частые вопросы
Какой навык вы проверите на своей задаче первым и по каким признакам поймёте, что он справился? Напишите в комментариях в канале.
Источники
- Anthropic: Claude Code Skills - установка, вызов, сравнение и диагностика.
- Anthropic: безопасность - проверка файлов и зависимостей.
- Anthropic: skills - pdf и document-skills.
- Corey Haines: marketingskills - copywriting, новые имена.
- Vercel: agent-skills - web-design-guidelines.
Новые материалы - дайджестом, без спама
Гайды выходят регулярно. Подпишись, чтобы не пропускать: пришлю подборку в Telegram или на email. Раз в неделю или каждый день - выбираешь сам.

