Claude Code Skills: собери библиотеку и проверь каждый навык

Опубликовано 19.05.2026Обновлено 08.11.20268 мин чтенияСредний
Артемий Миллер в кепке с логотипом Claude Code рядом с такими же логотипами и надписью «БИБЛИОТЕКА НАВЫКОВ 2026».
Что узнаешь
  • Как выбрать навыки под задачи своего проекта
  • Куда положить SKILL.md и как проверить вызов
  • Как сравнить результат с навыком и без него
Средний
3.9kпросмотров
18поделились
Что понадобится

Главное с 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 проверяйте его сами

С обновлениями будьте осторожны: автора могут взломать, аккаунт увести, в репозиторий может прилететь зловред. Всё ставите под свою ответственность.

Перед копированием:

  1. Прочитайте SKILL.md целиком: понятны ли действия и их назначение?
  2. Просмотрите связанные программы, справочники и ресурсы, включая scripts/.
  3. Проверьте внешние обращения и зависимости: куда уходят данные, что скачивается и запускается?
  4. Проверьте, какие файлы навык читает и меняет. Прочитайте allowed-tools: это предварительное разрешение перечисленным инструментам на время вызова. Поле не ограничивает весь доступный набор инструментов.

Непонятную или ненужную операцию не запускайте. Проверяйте файлы и зависимости навыков даже из репозитория Anthropic.

Первый запуск делайте в отдельном пробном репозитории без секретов. Чужие инструкции вслепую в рабочий проект не переносите. Пробный репозиторий полной изоляции не даёт.

Библиотека под свою задачу

Скопировать навык недостаточно. Нужно его адаптировать под свои данные, под свою задачу.

Выберите из таблицы навык под текущую работу. Папки здесь размещаются вручную, каждый результат нужно проверить на своих файлах.

ЗадачаТипИсточникМесто установкиВызовОбраз результата
Разобрать изменения GitОтдельный summarize-changesClaude Code~/.claude/skills/summarize-changes/SKILL.md/summarize-changes или What did I change?Резюме изменений и риски
Извлечь поля PDFОтдельный pdfAnthropic.claude/skills/pdf//pdf с задачей и файломПоля, сверенные с PDF
Написать текст страницыОтдельный copywritingmarketingskills.claude/skills/copywriting//copywriting с заданием и даннымиЧерновик без выдумок о продукте
Проверить интерфейсОтдельный web-design-guidelinesVercel.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

В обычном терминале выполните:

bash
mkdir -p ~/.claude/skills/summarize-changes

Откройте в редакторе файл ~/.claude/skills/summarize-changes/SKILL.md и сохраните образец из документации:

markdown
---
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 и модельЗаполнитеТе же
Источник и редакция навыкаЗаполнитеВыключен
Исходная разница и запросСохранитеТе же
Обнаружение и запись вызоваПриложите записиПроверьте отсутствие вызова
ОтветСохранитеСохраните
Файл и смысл правки названы верноДа / нет, фрагмент ответаДа / нет, фрагмент ответа
Нет выдуманных измененийДа / нет, сверка с исходникомДа / нет, сверка с исходником
Риски соответствуют правкеДа / нет, обоснованиеДа / нет, обоснование

Если выигрыша нет, установка сама по себе не делает навык полезным. Для других навыков из таблицы повторите проверку со своими файлами и условиями приёмки.

Если хотите собрать такой порядок работы для своего проекта с ИИ-агентами, посмотрите программу практикума СмыслоКода.

Практикум по вайб-кодингу
+Твой второй мозг
3 вечера - инструменты, метод, первый проект
Старт 24–26 ноября  ·  2 000 ₽
Записаться →

Много не надо. Навык для узкой задачи оставьте в проекте

Для каждого нужного навыка сохраните назначение, источник, способ установки, условия вызова и критерии проверки результата.

Ненужные личные и проектные навыки выключайте через /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 Code: голосовым вводом, субагентами, рутинами, MCP, CLAUDE.md, Hooks, планами и Git.

Навык есть, но Claude может его не выбрать: где искать причину

Claude заглядывает в папку навыков и смотрит описание, но иногда может не зацепить нужный навык. Найдите в таблице, на чём остановилась проверка.

СостояниеЧто проверитьЧто сделатьПовторная проверка
Нет в доступныхОбласть, путь, SKILL.md, совпадения имён, видимость, YAMLИсправить найденный дефект; первый --- поставить на первую строкуЗапросить список навыков
Есть, но не вызываетсяdescription, запрос, флаги вызова, paths, рабочий каталогИсправить условие выбора или настройкуПовторить явный и автоматический вызов
Вызывается, но ответ не принятВходные файлы, инструкцию, зависимости, образ результатаИсправить то, что не прошло приёмкуСверить ответ в свежей сессии

При ошибке YAML инструкция может загрузиться с пустыми метаданными. На версии от v2.1.233 проверьте разметку: в обычном терминале выберите команду для проектной или личной папки соответственно.

bash
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 и проверили снова.

Вопросы и ответы

Частые вопросы

Какой навык вы проверите на своей задаче первым и по каким признакам поймёте, что он справился? Напишите в комментариях в канале.

Источники

Практикум по вайб-кодингу
+Твой второй мозг
3 вечера - инструменты, метод, первый проект
Старт 24–26 ноября  ·  2 000 ₽
Записаться →

Новые материалы - дайджестом, без спама

Гайды выходят регулярно. Подпишись, чтобы не пропускать: пришлю подборку в Telegram или на email. Раз в неделю или каждый день - выбираешь сам.

Была инструкция полезна?
Артемий Миллер
Автор
Артемий Миллер
Предприниматель и вайб-кодер

Артемий Миллер - предприниматель и вайб-кодер. Бывший программист, собирает продукты исключительно вместе с ИИ-агентами, без найма разработчиков.

Тема
Как настроить CLAUDE.md в 2026: готовый шаблон и 6 правил
Главная статья темы
Соседние статьи

Связанные инструкции

Как настроить CLAUDE.md в 2026: готовый шаблон и 6 правил

Готовый шаблон CLAUDE.md, 6 правил живого файла и разбор боевого примера действующего бизнеса. Скопировал, вставил, Claude перестал забывать твой проект между сессиями.

28 мин

Куда уходят токены в Claude Code: 9 паттернов потери и как закрыть в 2026

Boris Cherny из Anthropic говорит - 73% твоих токенов в Claude Code теряется до того, как модель прочитает твой запрос. 14% уходит на CLAUDE.md, 13% - на пересчитывание истории, до 49% - на MCP-серверы. Разбираю все 9 паттернов и даю чек-лист первой чистки за 15 минут.

22 мин

Claude Code Subagents в 2026: пошаговая инструкция и 5 готовых примеров

Subagents Claude Code - специалисты с собственным контекстом и инструментами, к которым главный чат делегирует узкие задачи. Структура файла, формула description, 5 готовых ролей, антипаттерны и связка с Multi-agent v2 Anthropic.

21 мин

Лимиты Claude Code: как не жечь токены на переделки

При исчерпанной квоте Claude Code нужно дождаться сброса или выбрать официальное платное продолжение. /compact сжимает историю; сократить лишнюю работу помогают согласованный план и сохранённое состояние задачи.

10 мин