Скиллы Claude Code: что это и как написать свой

Скиллы Claude Code (skills) – это папки с файлом SKILL.md, в которых записана инструкция для конкретной задачи: релиз, проверка кода, оформление коммита. Claude подключает скилл сам, когда запрос подходит под его описание, либо вы вызываете его командой /имя-скилла. Создать свой можно за пять минут: папка в ~/.claude/skills/, файл SKILL.md с кратким описанием и инструкцией на Markdown. Отличие от файла CLAUDE.md простое: текст скилла загружается в контекст только когда он нужен, поэтому длинные регламенты почти ничего не стоят, пока вы ими не пользуетесь. Все данные ниже – из официальной документации Claude Code (code.claude.com/docs, раздел Skills) по состоянию на октябрь 2026.

Что такое скилл и когда он нужен

Документация советует создавать скилл, когда вы постоянно вставляете в чат одни и те же инструкции, чеклист или многошаговую процедуру, либо когда раздел CLAUDE.md разросся в процедуру, а не в факт. Простой ориентир:

• Факт или правило, которое всегда в силе («тесты запускаем командой npm test», «пишем на TypeScript») – в CLAUDE.md. Подробнее о таких файлах – в «Claude Code или Codex», где сравнивается CLAUDE.md с AGENTS.md.
• Процедура из нескольких шагов («выпуск релиза», «проверка pull request по нашему чеклисту») – в скилл.

Скиллы Claude Code следуют открытому стандарту Agent Skills, который работает в нескольких ИИ-инструментах. Claude Code добавляет к нему свои расширения: управление вызовом, запуск в субагенте и подстановку живых данных. Старые «пользовательские команды» из папки .claude/commands/ объединены со скиллами: файл .claude/commands/deploy.md и скилл .claude/skills/deploy/SKILL.md создают одну и ту же команду /deploy. Старые файлы продолжают работать, но для нового лучше использовать скиллы: у них есть папка для дополнительных файлов.

В Claude Code уже есть встроенные скиллы: например /doctor, /code-review, /batch, /debug, /loop и /claude-api. Они вызываются так же, как ваши, – набором / и имени.

Если вы только устанавливаете Claude Code, сначала прочитайте «Claude Code: руководство для новичка». Условия доступа из России и оплата описаны в статье «Как оплатить Claude и ChatGPT из России».

Первый скилл за пять минут

Пример из документации: скилл, который описывает неотправленные изменения в git-репозитории и отмечает рискованные места.

Шаг 1. Создайте папку в личных скиллах – они доступны во всех ваших проектах:

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

Шаг 2. Сохраните в ~/.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.

Строка !`git diff HEAD` – это «внедрение динамического контекста»: Claude Code выполняет команду и подставляет её вывод вместо строки до того, как Claude увидит текст скилла. Поэтому инструкция приходит уже с актуальным списком изменений.

Шаг 3. Откройте git-проект, внесите любую правку и запустите claude. Проверить можно двумя способами: спросить «Что я изменил?» (Claude подключит скилл сам, потому что запрос подходит под описание) или вызвать его напрямую командой /summarize-changes.

Описание лучше писать на языке, на котором вы обычно общаетесь с Claude, и включать в него слова, которыми вы реально формулируете просьбу. Для русскоязычного запроса можно добавить русские формулировки к английским.

Где хранить скилл

От места зависит, в каких сессиях скилл загрузится.

Уровень	Путь	Где работает
Личный	~/.claude/skills/<имя>/SKILL.md	Во всех ваших проектах на этом компьютере (но не в сессиях Cowork и облачных)
Проектный	.claude/skills/<имя>/SKILL.md	В сессиях этого репозитория; закоммитьте, чтобы он был у всей команды
Вложенный	<подпапка>/.claude/skills/<имя>/SKILL.md	В сессиях, запущенных в этой подпапке или ниже; загружается, когда Claude работает с файлами оттуда
Плагин	<плагин>/skills/<имя>/SKILL.md	Там, где включён плагин, команда вида /плагин:скилл
Корпоративный	В каталоге управляемых настроек	У всех пользователей организации

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

Изменения в папках скиллов Claude Code подхватывает без перезапуска. Исключение – если вы создали верхнюю папку skills, которой не было в начале сессии: тогда выполните /reload-skills. Список доступных скиллов показывает команда /skills.

Поля шапки: что можно настроить

Все поля необязательны, но description рекомендуется. Основные:

Поле	Что делает
name	Имя команды в меню /; по умолчанию – имя папки
description	Что делает скилл и когда его применять; по нему Claude решает, подключать ли скилл
when_to_use	Дополнительные фразы-триггеры; добавляется к описанию
user-invocable	Значение false прячет скилл из меню и оставляет его только Claude
argument-hint	Подсказка в автодополнении, например [номер-задачи]
arguments	Именованные аргументы для подстановки $имя в тексте
disable-model-invocation	Значение true запрещает Claude подключать скилл самостоятельно
allowed-tools	Инструменты, которые можно использовать без запроса разрешения во время работы скилла
model	Модель на время работы скилла
context: fork и agent	Запуск скилла в отдельном субагенте
paths	Маски файлов: скилл подключается автоматически только при работе с подходящими файлами

Важные детали из документации:

• Шапка читается, только если первая строка файла – ---. Иначе весь файл считается текстом скилла.
• Если YAML в шапке с ошибкой, скилл всё равно загрузится, но без полей: команда /имя работает, а Claude не сможет подобрать его по описанию. Причину покажет запуск с --debug.
• Описание и when_to_use вместе обрезаются в списке скиллов на 1536 символах – главное пишите в начале.

Кто запускает скилл: вы или Claude

По умолчанию скилл могут вызвать оба: вы командой /имя и Claude автоматически, когда это подходит к разговору. Два поля меняют это:

• disable-model-invocation: true – только вы. Подходит для действий с побочными эффектами или когда важен момент запуска: /commit, /deploy, /send-slack-message. Документация объясняет: вы не хотите, чтобы Claude решил выложить релиз только потому, что код выглядит готовым.
• user-invocable: false – только Claude. Подходит для фонового знания, которое не имеет смысла вызывать командой, например описание устройства старой системы: скилл скрыт из меню /.

Так что есть удобное правило: всё, что что-то отправляет, удаляет или публикует, делайте ручным. Всё безопасное и справочное оставьте автоматическим.

Дополнительные файлы, аргументы и субагенты

Дополнительные файлы. В папке скилла может лежать не только SKILL.md, но и справочники и скрипты. Тогда основной файл остаётся коротким, а подробности подгружаются по мере надобности:

my-skill/
├── SKILL.md       (обязательный: обзор и навигация)
├── reference.md   (подробный справочник, загружается при необходимости)
├── examples.md    (примеры)
└── scripts/
    └── helper.py  (скрипт, который выполняется, а не загружается)

В SKILL.md ссылайтесь на эти файлы и пишите, когда их читать. Документация рекомендует держать SKILL.md короче 500 строк.

Аргументы. Всё, что вы напишете после имени скилла, доступно в тексте как $ARGUMENTS; можно объявить именованные аргументы в поле arguments и использовать их как $имя. Например, arguments: [issue, branch] даёт подстановки $issue и $branch.

Субагент. Поле context: fork запускает скилл в новом субагенте, которому текст скилла передаётся как задание. Субагент не видит историю вашего разговора, поэтому инструкции должны быть самодостаточными. По умолчанию такой субагент работает в фоне, а результат приходит в беседу по завершении. Подходит для задач с чёткими шагами, а не для общих рекомендаций.

Скиллы связаны с MCP: скилл описывает, как действовать, а MCP-сервер даёт доступ к внешним системам. Об этом – в статье «MCP для новичка».

Как писать скиллы, которые работают

• Одна задача – один скилл. «Релиз» и «проверка кода» – два скилла, а не один «помощник для всего».
• Описание – это триггер. Напишите, что делает скилл и в каких случаях его применять, словами, которые вы реально используете в запросах.
• Главное – в начале. После сжатия контекста Claude Code сохраняет из вызванного скилла только начало (первые 5000 токенов каждого, общий лимит 25000 токенов), поэтому самые важные инструкции ставьте наверх.
• Пишите правила для всей задачи. Текст скилла попадает в разговор при вызове и не перечитывается на следующих ходах. Формулировка «запускай тесты после каждой правки» работает лучше, чем «запусти тесты».
• Жёсткие правила – в хуки. Если правило должно выполняться всегда, документация советует перенести его в hook: он срабатывает на каждое событие независимо от того, следует ли Claude скиллу.
• Коротко и конкретно. Не пересказывайте то, что Claude и так знает; описывайте только ваши соглашения.

Если скилл не срабатывает

Документация перечисляет типичные случаи.

• Скилл не подключается сам. Проверьте, что в описании есть слова, которые вы реально произносите; что скилл виден в списке доступных; перефразируйте запрос ближе к описанию; вызовите напрямую через /имя. Если YAML сломан, запустите с --debug – увидите ошибку разбора.
• Скилл срабатывает слишком часто. Сделайте описание конкретнее или добавьте disable-model-invocation: true.
• Claude перестал следовать скиллу. Причины – правило нужно перенести в хук; формулировка относилась к одному шагу, а не ко всей задаче; контекст был сжат (вызовите скилл заново).
• Описания обрезаны. Когда скиллов много, Claude Code убирает описания у редко используемых, чтобы уложиться в бюджет списка (1 % окна контекста модели). Команды /doctor и /skill-doctor помогают найти скиллы, которые стоит отключить.

Плагин-разработчикам: проверить синтаксис файлов можно командой claude plugin validate, указав папку со скиллами (нужна версия Claude Code 2.1.233 или новее).

Скиллы в других инструментах

Раз формат – открытый стандарт, похожие идеи есть и в других агентах. Например, в Hermes Agent скиллы пишут тоже в SKILL.md: см. «Hermes Agent: создание SKILL.md». Но поля шапки в разных инструментах различаются: документация Claude Code прямо предупреждает, что часть полей (например argument-hint) – расширения Claude Code, которые не принимает загрузка скиллов в claude.ai и через API (там допустимы name, description, license, compatibility, metadata, allowed-tools). Если вы хотите переносимый скилл, ограничьтесь этими полями.

Если вы хотите системно учиться работать с агентами, посмотрите подборку «Курсы по ИИ-агентам: как выбрать и что бесплатно»: в Anthropic Academy есть курс про скиллы Claude Code.

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

Чем скилл отличается от CLAUDE.md?

CLAUDE.md – постоянные правила и факты, которые Claude учитывает всегда. Скилл – процедура, текст которой загружается только при вызове, поэтому длинные инструкции почти не расходуют контекст до этого момента.

Чем скилл отличается от слэш-команды?

Ничем по сути: пользовательские команды из .claude/commands/ объединены со скиллами, оба варианта дают команду /имя. Скиллы добавляют папку с файлами, управление вызовом и автоматическую подгрузку.

Где лежат скиллы?

Личные – в ~/.claude/skills/, проектные – в .claude/skills/ репозитория, плагинные – внутри плагина. Корпоративные раздаёт администратор через управляемые настройки.

Нужно ли перезапускать Claude Code после правки скилла?

Обычно нет: изменения в папках скиллов подхватываются в текущей сессии. Если создали новую верхнюю папку skills, выполните /reload-skills.

Как запретить Claude запускать скилл самому?

Добавьте в шапку disable-model-invocation: true. Скилл будет запускаться только вашей командой /имя.

Можно ли использовать скиллы в облачных сессиях и Cowork?

Личные скиллы с вашего компьютера в Cowork и облачных сессиях не читаются. Там работают скиллы, включённые в вашем аккаунте claude.ai, а в облачных сессиях – ещё и проектные скиллы из закоммиченной папки .claude/skills/.

Сколько можно писать в скилле?

Документация рекомендует держать SKILL.md короче 500 строк, а подробные справочники выносить в отдельные файлы рядом.

Работает ли Claude Code из России?

Официально нет: Россия не входит в список стран, где работают сервисы Anthropic, российские карты не принимаются. Способы оплаты разобраны в статье «Как оплатить Claude и ChatGPT из России».