Зачем это нужно
Если ты гоняешь Claude на серьёзных задачах, наступает момент: ты в десятый раз объясняешь одно и то же. Как оформлять коммиты. Как писать Title под SEO. Какой у тебя стек и стиль кода. Каждую сессию — заново. Промпт разрастается, а половина инструкций нужна не всегда, а раз в неделю.
Скиллы (Claude Skills, они же Agent Skills) решают ровно это. Ты один раз описываешь процедуру или знание в файле SKILL.md, и дальше Claude достаёт его сам — но только когда задача подходит. Остальное время скилл не занимает контекст. Разберу, как они устроены, как собрать свой за пять минут и куда его положить — в Claude Code, в веб-версии Claude.ai и через API.
Коротко для тех, кто спешит: скилл — это папка с файлом SKILL.md внутри. В файле — описание (когда его применять) и инструкции (что делать). Кладёшь папку в нужное место — и всё.
Что такое скилл и как он грузится
Скилл — это переиспользуемый навык в виде markdown-файла. Не плагин, не код, который надо компилировать, а текст с инструкциями плюс, по желанию, скрипты и справочные файлы рядом. Главная фишка — progressive disclosure, поэтапная загрузка. Именно она отличает скилл от «просто большого промпта».
Отсюда практический вывод: скиллов может быть много — десятки, — и они не раздувают контекст, пока не понадобятся. С обычным большим промптом так не выйдет: он весь и всегда в контексте.
Посчитаем на пальцах. Пусть у тебя скилл на 10 000 токенов плюс справочный файл ещё на 5 000. Если в этой сессии он не пригодился — ты заплатил только за описание, сотню токенов. Если пригодился один раз — полная стоимость, но ровно один раз за сессию, а не в каждом запросе. Двадцать таких скиллов в фоне стоят копейки, пока молчат. Тот же объём знаний в промпте или CLAUDE.md висел бы в каждом сообщении и быстро съел бы окно.
Ещё нюанс на длинных сессиях: когда контекст переполняется и происходит компактация, у уже использованных скиллов сохраняется верхняя часть — самое важное. Если скилл нужен целиком после этого, его достаточно вызвать заново.
Два типа скиллов
По сути скиллы бывают двух видов, и держать их в голове раздельно удобно — от типа зависит, как ты его настроишь.
На практике граница гибкая: один скилл может и объяснять правило, и выполнять по нему действие. Но когда сомневаешься, как настроить, — спроси себя: это справка, которую Claude читает между делом, или команда, которую он запускает? От ответа зависит, ставить disable-model-invocation или нет.
Анатомия SKILL.md
Весь скилл — это один обязательный файл SKILL.md. Он состоит из двух частей: YAML-шапка (frontmatter) сверху и инструкции ниже. Минимально нужны два поля в шапке.
description Claude читает при старте и по нему решает, когда скилл достать — поэтому пиши его конкретно.Ключевые поля шапки:
| Поле | Зачем |
|---|---|
| description | главное поле: что делает скилл и когда применять. По нему Claude вызывает скилл сам |
| name | имя (по умолчанию = имя папки). Под ним вызываешь вручную: /seo-title |
| allowed-tools | инструменты, что разрешены без лишнего запроса, пока скилл активен |
| disable-model-invocation | true — только ручной вызов. Для скиллов с побочными эффектами (деплой) |
description — с него всё и начинается. Остальное опционально.Если инструкций много, не пихай всё в один файл. Клади рядом reference.md, примеры и скрипты, а в SKILL.md ссылайся на них — Claude подтянет их только когда полезет глубже.
Живые данные и аргументы
Скилл — не статичная памятка. Он умеет две вещи, которые превращают его в рабочий инструмент: подставлять свежие данные прямо в момент вызова и принимать аргументы, как shell-скрипт.
Живой контекст через !`команда`
Строка вида !`git diff HEAD` в теле скилла выполняется в момент активации, и Claude получает результат сразу в контекст. Не «сходи проверь», а уже готовые данные под задачей:
Аргументы
Скилл принимает параметры через $0, $1 или $ARGUMENTS — как shell-скрипт. Вызываешь /deploy production, и внутри скилла $0 = production. Так один скилл работает под разные окружения без копий.
!`команда` работает только в теле, не в шапке. И это preprocessing — команда реально запускается при активации скилла. Поэтому для скиллов с побочными эффектами (деплой, отправка) ставь disable-model-invocation: true, чтобы Claude не дёрнул их сам.
Как создать свой скилл
Ничего собирать не надо — создаёшь папку и файл. Вот личный скилл, доступный во всех твоих проектах (для Claude Code):
~/.claude/skills/. Проектный, который поедет в репозиторий и будет общим для команды, — в .claude/skills/ внутри проекта.Главное правило хорошего скилла — сильное описание. Ставь ключевой сценарий в начало («Генерирует SEO Title…», а не «Этот скилл анализирует…») и добавь фразы-триггеры («когда просят заголовок»). По описанию Claude решает, доставать скилл или нет — размытое описание = скилл не сработает.
Как писать description, чтобы скилл срабатывал
Почти все проблемы со скиллами — в описании. Claude выбирает скилл только по полю description, полного текста он в этот момент не видит. Размытое описание — и скилл пылится, даже если внутри всё идеально.
Четыре правила рабочего описания:
1. Ключевой сценарий — в начало. «Генерирует SEO Title…», а не «Этот скилл предназначен для…». Первые слова весят больше.
2. Фразы-триггеры. «Использовать, когда просят…», «Подходит для…» — прямо называй ситуацию, в которой скилл нужен.
3. Конкретика вместо «разное/полезное». Абстракции Claude не с чем сопоставить.
4. Держи до ~1500 символов. Длиннее — обрежется, и хвост описания просто не прочитается.
Полный пример: скилл со скриптом
Теперь настоящий скилл, а не «hello world»: считает статистику текста — слова, время чтения, плотность ключа — через маленький питон-скрипт. Тут видно, как в скилл кладут исполняемый код. Структура папки:
Файл SKILL.md — инструкция + вызов скрипта:
И сам скрипт scripts/stats.py:
/content-stats article.md "автоотклик" — Claude запустит скрипт, получит цифры и объяснит их человеческим языком.Мораль: markdown-инструкции — для мягких правил и знаний, а скрипты — для точных вычислений и валидации. Скилл объединяет и то, и другое в одной папке.
Второй пример: скилл на bash
Скрипт в скилле — это не обязательно питон, а любой исполняемый код, хоть bash. Соберём боевой: проверка статьи перед публикацией — длина Title, число внутренних ссылок и стоп-слова из отдельного файла. Заодно покажу многофайловый скилл, где список правил вынесен в references/ и подгружается отдельно от инструкции.
Файл SKILL.md — короткая инструкция: что запустить и как читать вывод.
Скрипт scripts/check.sh делает всю точную работу — на чистом bash:
references/stop-words.txt — по слову на строку (данный, является, в рамках…). Правишь список — логику скрипта трогать не нужно.Вызов: /pre-publish blog/new-post/index.html. Claude запустит скрипт, увидит «в тексте 3 раза "является"» — и предложит переписать эти места живым языком. Точную проверку делает bash, а осмысление и правку — сам Claude. Это и есть разделение труда внутри одного скилла.
allowed-tools и безопасность
Скилл может запускать команды и скрипты — значит, стоит понимать, что он делает с твоей машиной. Управляется это полем allowed-tools: оно заранее одобряет инструменты, пока скилл активен, чтобы Claude не спрашивал разрешение на каждый шаг. Задаётся glob-паттернами:
Ключевой момент: allowed-tools — это не ограничение, а предодобрение. Claude всё ещё может запросить инструмент, которого нет в списке, — просто спросит разрешение. Если нужно именно запретить, есть обратное поле disallowed-tools.
Правила безопасности: не ставь чужой скилл не глядя — открой SKILL.md и скрипты, посмотри, что он запускает. Проектные скиллы из незнакомого репозитория требуют подтверждения доверия к папке. А скиллы, которые деплоят или что-то отправляют, держи на disable-model-invocation: true, чтобы Claude не дёрнул их без твоей команды.
Как установить скилл
Где скилл жить будет — зависит от того, чем ты пользуешься. Три поверхности, три способа.
Готовый набор скиллов ставится из официального маркетплейса Anthropic одной командой прямо в сессии Claude Code:
Как раздать скилл команде
Личный скилл в ~/.claude/skills/ живёт только у тебя. Чтобы им пользовалась вся команда — положи его в проектную папку .claude/skills/ и закоммить в репозиторий. Дальше он едет вместе с кодом: клонировал проект — скилл уже на месте. Это превращает наработки одного человека в общую «мышечную память» команды.
Если имена совпали (личный и проектный скилл называются одинаково), Claude берёт по приоритету:
Хочешь раздать скилл шире одного репозитория — упакуй его в плагин и опубликуй в маркетплейс. Тогда любой поставит его командой /plugin install, как официальные наборы Anthropic.
Готовые скиллы: что уже есть
Свой писать не обязательно — многое уже готово. Официальный репозиторий anthropics/skills (под 160 тысяч звёзд) — это и библиотека примеров, и шаблон для своего скилла.
/code-review, /debug, /batch, /loop и другие — тоже скиллы.skill-creator — скилл, который тестирует и улучшает твои скиллы: гоняет их на примерах и предлагает, как усилить описание.Конкретные скиллы, которые стоит забрать первыми — ссылки прямые, на официальный репозиторий:
Разбор боевого скилла: как устроен pdf
Теория складывается, когда разбираешь живой скилл по косточкам. Возьмём официальный pdf от Anthropic — он читает, режет, склеивает и шифрует PDF, заполняет формы, гонит OCR по сканам. И это эталон того, как прогрессивное раскрытие работает на практике.
Первое, на что стоит посмотреть, — его description. Вот он почти как есть (чуть подрезан):
Заметь, как описание перечисляет чуть ли не каждый сценарий и синоним: reading, extracting, merging, splitting, filling forms, OCR. Это не многословие ради объёма, а приманка для срабатывания: как бы человек ни сформулировал запрос про PDF, он попадёт в одну из этих формулировок — и Claude подхватит скилл. Первый урок разбора: description пишут под то, как реальные люди просят, а не как покрасивее.
Теперь структура папки — и тут вся соль:
Эти файлы грузятся не сразу, а тремя уровнями — по мере надобности:
description, ~60 токенов. Claude просто знает, что есть скилл про PDF.SKILL.md (314 строк): обзор и быстрый старт под типовые операции.reference.md (611 строк) для редких операций или forms.md для форм и запускает нужный скрипт из scripts/.Ключевой вывод: reference.md на 611 строк весит ноль токенов, пока ты не попросишь что-то нетривиальное. forms.md не открывается, пока речь не зашла о формах. Скилл может быть сколь угодно большим и умным — в контексте он занимает крохи, потому что тяжёлые куски лежат на полке и снимаются только под конкретную задачу. Ровно так строй и свои: короткий SKILL.md сверху, тяжёлые справочники и скрипты — отдельными файлами рядом.
Какие скиллы собрать первым делом
Абстракции абстракциями, но вот пять скиллов, которые реально экономят время, если работаешь с контентом и трафиком. Каждый — папка с SKILL.md, собирается за вечер, а окупается на первой же неделе.
Через месяц такой работы у тебя личная библиотека навыков, которая едет за тобой из проекта в проект. Начни с одного — самого частого повтора в твоей рутине, — и добавляй по мере того, как ловишь себя на «опять объясняю то же самое». Заготовки под контент-скиллы, кстати, уже есть в подборке промтов для SEO-контента — их легко завернуть в SKILL.md.
Скилл vs MCP, сабагенты и CLAUDE.md
Скиллы часто путают с соседними механизмами. Разница простая: скилл — это знание и процедура для самого Claude, а не подключение и не отдельный воркер.
| Механизм | Что это | Когда брать |
|---|---|---|
| Скилл | инструкции и знания, что грузятся по требованию | повторяемые процедуры, справочники, воркфлоу |
| MCP | протокол подключения внешних сервисов | база данных, Slack, браузер, внешние API |
| Сабагент | изолированный воркер со своим контекстом | параллельная работа, тяжёлый ресёрч по многим файлам |
| CLAUDE.md | контекст, что грузится всегда и целиком | правила «всегда делай так» (стек, стиль) |
Они не конкурируют, а складываются. Частый сценарий: MCP даёт инструмент к базе, а скилл учит Claude твою схему и правила запросов — инструмент есть, знание как им пользоваться тоже.
Если скилл не срабатывает
Четыре самых частых грабли — и что делать.
description. Начинай проверку с них.Частые вопросы
Что такое Claude Skills простыми словами?
Чем скилл отличается от обычного промпта или CLAUDE.md?
Как добавить скилл в Claude Code?
Как установить скилл в Claude.ai?
Скиллы для Claude бесплатные?
Где взять готовые скиллы?
Чем скилл отличается от MCP?
Главное
Скилл — папка с файлом SKILL.md: сверху описание (когда применять), ниже инструкции (что делать). Claude грузит его по требованию — пока не пригодился, в контексте только описание, поэтому скиллов может быть сколько угодно. Создаёшь за минуту: mkdir + файл в ~/.claude/skills/. Ставишь готовые из anthropics/skills или маркетплейса. Секрет рабочего скилла — сильное description с ключевым сценарием в начале.
Официальные примеры и шаблон скилла — в репозитории anthropics/skills. Начни с готового, потом сделай свой под свой воркфлоу.