Скилл Claude Code - это просто папка с файлом SKILL.md: YAML-заголовок с описанием плюс markdown-инструкции. Разобрали по официальной документации Claude Code, как создать минимальный рабочий скилл за три шага, какие поля frontmatter реально влияют на поведение, и как плагин skill-creator помогает протестировать и улучшить готовый скилл.
Коротко о главном
Скилл расширяет возможности Claude, объединяя YAML frontmatter-конфигурацию с markdown-инструкциями - Claude автоматически загружает его, когда это релевантно задаче, либо вы вызываете его напрямую командой /имя-скилла. Файл SKILL.md обязателен, минимум с полем description. Расположение определяет область действия: ~/.claude/skills/<имя>/SKILL.md - личный скилл для всех ваших проектов; .claude/skills/<имя>/SKILL.md - проектный, коммитится в репозиторий для команды; путь в managed settings - организационный. Ключевые поля frontmatter: description (когда Claude должен загрузить скилл автоматически), name (отображаемое имя), disable-model-invocation (только ручной вызов), allowed-tools (заранее одобренные инструменты), arguments (именованные позиционные аргументы). Синтаксис вида !`git diff HEAD` внутри SKILL.md выполняет команду до того, как Claude увидит скилл, вставляя живой вывод в промпт. Официальный плагин skill-creator (/plugin install skill-creator@claude-plugins-official) автоматизирует разработку - фиксирует тест-кейсы, запускает изолированные сравнения с скиллом и без него, оценивает результат по критериям и предлагает улучшения описания.
Что такое скилл и минимальная структура
Официальная документация Claude Code (code.claude.com/docs/en/skills) определяет скилл как расширение возможностей Claude через сочетание YAML frontmatter-конфигурации с markdown-инструкциями. Когда задача релевантна, Claude загружает скилл автоматически - либо вы вызываете его напрямую командой /имя-скилла. Каждый скилл требует файл SKILL.md из двух частей: frontmatter в тройных дефисах и содержательные markdown-инструкции ниже.
Где хранить файл: три уровня
| Расположение | Путь | Область действия |
|---|
| Личный | ~/.claude/skills/<имя>/SKILL.md | Все ваши проекты на этой машине |
| Проектный | .claude/skills/<имя>/SKILL.md | Текущий репозиторий (коммитится для команды) |
| Организационный | .claude/skills/ в managed settings | Вся организация |
Минимальный пример: скилл резюме изменений
Шаг 1 - создать директорию: mkdir -p ~/.claude/skills/summarize-changes.
Шаг 2 - написать SKILL.md:
---
description: Суммирует незакоммиченные изменения и отмечает риски. Использовать, когда пользователь спрашивает, что изменилось, хочет commit message, или просит проверить diff.
---
## Текущие изменения
!`git diff HEAD`
## Инструкции
Суммируй изменения выше в два-три пункта, затем перечисли замеченные риски - отсутствующую обработку ошибок, хардкод значений или тесты, которые нужно обновить. Если diff пуст, скажи, что незакоммиченных изменений нет.
Синтаксис !`git diff HEAD` выполняет команду до того, как Claude увидит скилл, вставляя живой вывод прямо в промпт.
Шаг 3 - протестировать: откройте git-проект, внесите правку, запустите Claude Code и спросите «что изменилось?», либо вызовите напрямую - /summarize-changes.
Ключевые поля frontmatter
- description - когда Claude должен загрузить скилл автоматически (например: «Суммирует незакоммиченные изменения...»)
- name - отображаемое имя (по умолчанию - имя папки)
- disable-model-invocation: true - вызывать может только пользователь вручную, Claude не запустит автоматически (для скиллов деплоя, коммитов)
- allowed-tools - заранее одобренные инструменты для хода скилла, например
Bash(git *) Read - arguments - именованные позиционные аргументы для подстановки, например
[issue-number] или [file] [format]
Тестирование через skill-creator
Официальный плагин skill-creator автоматизирует разработку скиллов с тестированием и итерацией. Установка: /plugin install skill-creator@claude-plugins-official.
Плагин фиксирует тест-кейсы в evals/evals.json, запускает изолированные сравнения с использованием скилла и без него, оценивает результат по заданным критериям, замеряет накладные расходы по токенам и времени, и предлагает улучшения описания. Для запуска достаточно попросить: «оцени мой скилл summarize-changes через skill-creator». Anthropic рекомендует именно этот плагин как отправную точку для любого нового скилла.
Что обязательно должно быть в файле SKILL.md?
Минимум - поле description в YAML frontmatter, объясняющее, что делает скилл и когда его использовать, плюс markdown-инструкции ниже.
В чём разница между личным и проектным скиллом?
Личный скилл лежит в ~/.claude/skills/ и доступен во всех ваших проектах на машине. Проектный лежит в .claude/skills/ внутри репозитория и коммитится, чтобы быть доступным всей команде.
Как сделать так, чтобы скилл вызывался только вручную, а не автоматически?
Добавить поле disable-model-invocation: true в frontmatter - Claude не будет запускать такой скилл сам, только по явной команде /имя-скилла.
Что делает синтаксис с обратными кавычками и восклицательным знаком внутри SKILL.md?
Команда вида !`git diff HEAD` выполняется ДО того, как Claude увидит скилл - живой вывод команды вставляется прямо в промпт.
Как протестировать качество написанного скилла?
Через официальный плагин skill-creator - он фиксирует тест-кейсы, запускает сравнение результатов с скиллом и без, оценивает вывод по критериям и предлагает улучшения описания.
Нужно ли загружать скилл через API, чтобы его использовать?
Нет, для Claude Code скиллы файловые - достаточно создать папку с SKILL.md в нужном месте на диске, никакой загрузки через API не требуется.
Источники (3)
- Claude Code Docs - Extend Claude with skills
- Claude Platform Docs - Agent Skills Overview
- GitHub - anthropics/skills
← Все статьи блога