Claude Skills: что это и как создать свой скилл

Коротко

Claude Skills (Agent Skills) — это папки с инструкциями, скриптами и справочными файлами, которые Claude подгружает сам, когда задача совпадает с описанием скилла. Минимальный скилл — один файл SKILL.md: YAML-шапка с полями name и description плюс тело в Markdown. От промпта скилл отличается тем, что живёт постоянно и активируется без вашего участия; от субагента — тем, что не создаёт отдельный контекст, а догружает знания в текущий. Первый рабочий скилл делается за 10–15 минут — ниже пошаговая инструкция и разбор формата.

Что такое Claude Skills и какую проблему они решают?

Скилл — это способ дать агенту процедурные знания «по требованию». Anthropic представила Agent Skills в октябре 2025 года, и сейчас формат работает в Claude Code, в приложениях Claude и через API — один и тот же скилл можно переносить между поверхностями.

До скиллов у повторяющихся инструкций было два плохих места. Либо CLAUDE.md, который загружается в каждую сессию целиком и раздувается до нечитаемости. Либо ручная копипаста промптов, которую вы забываете в самый нужный момент.

Скиллы решают это через progressive disclosure — постепенное раскрытие:

1. Discovery. На старте сессии Claude видит только name и description каждого скилла — десятки байт на штуку.
2. Activation. Когда задача совпала с описанием, агент читает весь SKILL.md в контекст.
3. Execution. По ходу работы он догружает справочные файлы и запускает скрипты из папки скилла — только те, что реально нужны.

Итог: можно держать 30 скиллов и почти не платить контекстом, пока они молчат. Если вы только настраиваете Claude Code, начните с гайда для начинающих — скиллы лягут на подготовленную почву.

Чем скилл отличается от промпта, CLAUDE.md и субагента?

Короткие определения, чтобы развести понятия:

• Промпт — это разовое сообщение агенту; живёт одну задачу, дальше вы печатаете его заново (как формулировать — в статье про постановку задач).
• CLAUDE.md — это память проекта: короткие правила, которые грузятся всегда и целиком.
• Скилл — это процедура по требованию: подробная инструкция, занимающая контекст только тогда, когда нужна.
• Субагент — это отдельный исполнитель со своим контекстным окном; ему делегируют объёмные подзадачи, чтобы не засорять основную сессию (подробнее — в статье про агентов и роли).
• MCP-сервер — это «руки»: доступ к внешним системам — БД, браузеру, API. Скилл — «голова»: знание, как действовать (разбор — в подборке MCP-серверов).

Практическое правило: третий раз печатаете один и тот же длинный промпт — это скилл. Инструкция нужна в каждой сессии и умещается в пару абзацев — это CLAUDE.md. Задача сжирает контекст на десятки тысяч токенов — субагент.

Как устроен SKILL.md?

Структура папки:

my-skill/
├── SKILL.md          # обязателен
├── references/       # справка, шаблоны — грузятся по мере надобности
└── scripts/          # исполняемые скрипты

Минимальный SKILL.md:

---
name: release-notes
description: Собирает release notes по git-логу. Использовать, когда просят «собери релиз-ноуты», «что вошло в релиз», «changelog с прошлого тега».
---

# Release notes

## Алгоритм
1. Возьми коммиты: `git log <последний-тег>..HEAD --oneline`.
2. Сгруппируй: фичи / фиксы / инфраструктура.
3. Оформи по шаблону из references/template.md.
4. Коммиты с префиксом `chore:` не включай.

Что важно в шапке:

• name — идентификатор до 64 символов, латиница и дефисы.
• description — это не документация, а триггер. Claude сопоставляет запрос пользователя именно с этой строкой. Пишите в неё реальные фразы, которыми вы просите задачу: «собери релиз-ноуты», «проверь миграцию». Расплывчатое «помогает с релизами» — главная причина, почему скилл молча не срабатывает.
• Опциональные поля в Claude Code: allowed-tools (ограничить доступные инструменты) и disable-model-invocation: true (скилл вызывается только вручную).

Тело — алгоритм, а не эссе: нумерованные шаги, команды, критерии готовности. Всё тяжёлое (шаблоны, длинные справки) выносите в references/ — тогда активация скилла стоит сотни токенов, а не тысячи.

Как создать первый скилл: пошагово

1. Выберите жертву. Повторяющаяся процедура с чёткими шагами: код-ревью по чек-листу проекта, деплой, оформление PR, генерация отчёта.
2. Создайте папку. ~/.claude/skills/имя-скилла/ — личный скилл для всех проектов; .claude/skills/имя-скилла/ внутри репозитория — проектный: поедет с git и достанется всей команде.
3. Напишите frontmatter. В description — триггерные фразы и границы применимости («НЕ использовать для hotfix-веток»).
4. Напишите тело. Шаги, команды, шаблон результата. Хороший тест: сможет ли по этой инструкции отработать новый сотрудник, не задав ни одного вопроса.
5. Перезапустите сессию Claude Code — скиллы подхватываются на старте.
6. Проверьте активацию. Сформулируйте задачу так, как писали в description, — скилл должен подхватиться сам. Потом спросите иначе и посмотрите, сработает ли. Не срабатывает — правьте description; попадание со второй-третьей итерации — это нормально.

Честная оговорка: активация вероятностная. Модель сама решает, брать ли скилл, поэтому в критичных процедурах дублируйте — вызывайте скилл явно (в Claude Code — слэш-командой с его именем) или упоминайте его в запросе.

Где взять готовые скиллы и как не нарваться?

Два источника:

• Официальный репозиторий anthropics/skills — открытые примеры от Anthropic: работа с docx, pptx, xlsx, pdf и другие. Полезен как эталон структуры.
• Подборка в нашем арсенале — в разделе /arsenal/skills/ собраны карточки готовых скиллов с инструкциями по установке: тестирование, ревью, документация, безопасность. Раздел бесплатный, как и весь арсенал.

Предупреждение по безопасности: скилл может содержать исполняемые скрипты, и они запускаются с вашими правами — уровень доверия тот же, что к npm-пакету. Чужой SKILL.md и папку scripts/ читайте до установки, а не после инцидента.

Скиллов стало много. Как не получить зоопарк?

Реальная боль появляется на масштабе. Пять скиллов живут спокойно. На пятнадцати начинаются пересечения триггеров и дубли правил между CLAUDE.md и скиллами. А если команда сидит и на Claude Code, и на Cursor, всё умножается на два: Cursor не читает SKILL.md, у него свой формат правил (.mdc), и одну и ту же процедуру приходится вести в двух местах, где она неизбежно расходится.

Мы упёрлись в это сами, поэтому в движке Quest пошли путём компиляции: правила, скиллы и роли описываются один раз в спеке движка, а под конкретный инструмент — Claude Code или Cursor — генерируются нативные артефакты: скиллы и CLAUDE.md для одного, правила для другого. Меняете спеку — пересобираете обе среды, рассинхрон исчезает как класс (как устроена переносимость — в отдельном разборе). На момент июля 2026 движок стоит 4900 ₽ разово, тематические модули — по 1900 ₽.

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

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

Работают ли Claude Skills в Cursor?

Нет. SKILL.md — формат Anthropic; Cursor использует собственные правила (.mdc в .cursor/rules). Процедуру можно портировать вручную, но поддерживать два формата параллельно накладно — это одна из задач, которую решает компиляция из единой спеки в Quest.

Чем скилл отличается от MCP-сервера?

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

Сколько скиллов можно подключить одновременно?

Технически — десятки: на этапе discovery каждый стоит только name и description. Практический потолок ниже: чем больше скиллов с похожими описаниями, тем чаще модель берёт не тот или не берёт никакой. Держите триггеры непересекающимися и удаляйте мёртвые скиллы.

Обязательно ли уметь программировать, чтобы написать скилл?

Нет. Минимальный скилл — это Markdown-файл с текстовой инструкцией, без кода. Скрипты в scripts/ — опция для случаев, когда шаг надёжнее выполнить детерминированным кодом, чем генерацией.