Skills для Claude — текстовые файлы с инструкциями, которые расширяют возможности ИИ-ассистента в инструменте Claude Code. Готовые навыки размещаются в директории ~/.claude/skills/ на компьютере или .claude/skills/ внутри проекта. Скачать их можно из публичных репозиториев на GitHub или написать самостоятельно в формате Markdown с YAML-метаданными. Установка сводится к копированию папки с файлом SKILL.md в нужную директорию. В этом руководстве рассматривается ручное размещение файлов в Claude Code.
Что такое Skills и чем они отличаются от обычных промптов
Навык Claude Code — структурированная инструкция, которая помогает ИИ выполнять специфические задачи: проверять код по стандартам компании, генерировать документацию или настраивать окружение для конкретного фреймворка. В отличие от разовых промптов, навык хранится локально и вызывается командой вида /skill-name или автоматически, если Claude считает его релевантным текущей задаче.
Каждый навык представляет собой директорию с обязательным файлом SKILL.md. Внутри — блок YAML frontmatter с метаданными (название и описание) и Markdown-инструкции для модели. Дополнительно можно положить вспомогательные файлы: шаблоны конфигураций, примеры кода или справочные таблицы. Claude читает эти материалы при активации навыка и следует прописанным правилам.
Навык задаёт повторяемый порядок работы, а MCP подключает внешние инструменты и источники данных. Навык может содержать вспомогательные скрипты и инструкции по вызову инструментов; перед установкой нужно проверить весь комплект. Формат Agent Skills используется разными инструментами, но настройки конкретного клиента могут отличаться.
Где найти готовые Skills для Claude
Начните с примеров в официальной документации Claude Code. Другой вариант — исходный репозиторий конкретного автора. Перед загрузкой прочитайте README, лицензию, историю изменений и содержимое файлов. Наличие слова «официальный» в названии сборника само по себе не подтверждает его происхождение.
Выбирайте навык под проверяемую задачу: например, проверку документации или подготовку отчёта об изменениях. До установки сформулируйте ожидаемый результат и пример, на котором сможете проверить инструкцию.
Третий вариант — сообщества разработчиков в Discord, Reddit и Telegram. Участники делятся готовыми конфигурациями, обсуждают ошибки и публикуют обновлённые версии навыков. Перед использованием стороннего навыка стоит проверить код: файл SKILL.md может содержать инструкции, которые изменяют поведение ИИ непредсказуемым образом.
Структура файла SKILL.md
Согласно официальной документации, файл SKILL.md содержит YAML frontmatter и текст инструкции. Поле description описывает назначение и случаи применения. Простой пример может обойтись этим полем; дополнительные параметры нужно сверять с документацией.
Пример минимального навыка:
SKILL.md
- YAML-блок: name: code-review, description: "Проверка кода на соответствие стандартам"
- Инструкция: "Проверь код на наличие неиспользуемых переменных, длинных функций (более 50 строк) и отсутствие комментариев к публичным методам"
- Дополнительно: ссылка на style guide компании или список игнорируемых правил
Вспомогательные файлы размещаются в той же директории. Если навык проверяет соответствие ESLint-правилам, рядом с SKILL.md можно положить .eslintrc.json. Claude прочитает этот файл и учтёт настройки при анализе кода.
Личные и проектные навыки: разница в области действия
Личные навыки хранятся в ~/.claude/skills/ и доступны во всех проектах, которые открываются в Claude Code. Это удобно для универсальных инструкций: форматирование логов, генерация README, проверка орфографии в комментариях. Один раз настроил — используешь везде.
Проектные навыки лежат в .claude/skills/ внутри конкретного репозитория. Их область применения связана с репозиторием. Избегайте совпадающих имён с личными навыками: в текущей документации личный навык имеет приоритет над проектным. Такой подход подходит для команд: навык с правилами code review коммитится в репозиторий, и все участники автоматически получают одинаковые инструкции для Claude.
| Параметр | Личные навыки (~/.claude/skills/) | Проектные навыки (.claude/skills/) |
|---|---|---|
| Область действия | Все проекты пользователя | Только текущий проект |
| Управление версиями | Не коммитятся в Git | Коммитятся вместе с кодом |
| Приоритет | Выше проектного при совпадении имени | Ниже личного при совпадении имени |
| Синхронизация в команде | Ручная | Автоматическая через Git |
Если названия совпадают, сначала проверьте, какой файл действительно используется. Различающиеся названия для личной и командной версии упрощают проверку: не приходится угадывать, какая из двух инструкций повлияла на ответ.
Пошаговая установка готового навыка
Ниже показана ручная установка через файлы. Другие способы распространения, включая плагины, описаны в документации; здесь достаточно каталога с выбранным навыком.
- Найди репозиторий с нужным навыком на GitHub. Убедись, что в корне есть файл SKILL.md с корректной структурой.
- Скачай архив репозитория или склонируй его командой git clone. Если навык — часть большого сборника, скопируй только нужную поддиректорию.
- Создай папку с именем навыка в ~/.claude/skills/ (для личного использования) или .claude/skills/ (для проекта). Имя папки должно совпадать с полем name в YAML-блоке.
- Скопируй SKILL.md и все вспомогательные файлы в созданную папку. Структура должна выглядеть так: ~/.claude/skills/code-review/SKILL.md.
- Открой Claude Code и начни новую сессию, если он был запущен. Навык появится в списке доступных и будет вызываться командой /code-review.
Проверить установку можно в чате Claude: напиши / и начни вводить название навыка. Если всё настроено правильно, ассистент предложит автодополнение и активирует навык после выбора. Подробнее о настройке рабочего окружения — в разделе руководств по инструментам.
Как вызвать навык и когда Claude активирует его автоматически
Прямой вызов — команда /skill-name в чате Claude Code. Это гарантирует, что ИИ прочитает инструкции из SKILL.md и применит их к текущей задаче. Например, /api-docs запускает навык генерации API-документации для выделенного фрагмента кода.
Для автоматического выбора важны описание description и соответствие текущей задаче. Не ожидайте точного срабатывания по одному слову: проверьте несколько подходящих и неподходящих запросов. Явный вызов /skill-name помогает отдельно проверить саму инструкцию.
Автоматический режим удобен для команд: разработчик просто описывает задачу естественным языком, а навыки срабатывают незаметно. Минус — непрозрачность: иногда непонятно, почему Claude выбрал именно этот навык. В таких случаях проще вызывать навыки явно через слэш-команды.
Создание собственного навыка: простой пример
Для разработки навыка не нужны специальные инструменты — достаточно текстового редактора. Задача: научить Claude проверять, что все функции в Python-файле содержат docstring с описанием параметров и возвращаемого значения.
- Создай директорию ~/.claude/skills/docstring-check/.
- Внутри создай файл SKILL.md со следующим содержимым:
---
name: docstring-check
description: "Проверка наличия docstring в Python-функциях"
---
Проверь каждую функцию в файле:
1. Есть ли docstring сразу после определения функции
2. Описаны ли все параметры в формате :param name: description
3. Указан ли возвращаемый тип через :return:
Выведи список функций без корректной документации.
- Сохрани файл и перезапусти Claude Code. Открой любой Python-проект и напиши: «Проверь docstring в main.py». Проверь, применился ли навык, либо вызови /docstring-check явно; затем сравни отчёт с исходным файлом.
Этот пример показывает минимальную структуру. Для усложнения можно добавить примеры правильных docstring, ссылки на PEP 257 или список исключений (например, magic-методы можно пропускать). Все дополнительные материалы кладутся в ту же папку и упоминаются в инструкции.
Типичные ошибки при работе со Skills
Навык не появляется в списке доступных — частая проблема при неправильном именовании папки или файла. Claude ищет строго SKILL.md (заглавные буквы) в поддиректории ~/.claude/skills/name/. Если файл назван skill.md или лежит напрямую в skills без вложенной папки, навык не загрузится.
Второй источник ошибок — некорректный YAML frontmatter. Пропущенное двоеточие, лишние пробелы или отсутствие закрывающих дефисов приводят к тому, что Claude не может распарсить метаданные. Проверить синтаксис можно в любом онлайн-валидаторе YAML перед копированием в SKILL.md.
Конфликт навыков с одинаковыми именами — личный навык имеет приоритет над проектным, но если в двух проектах есть навыки с разными инструкциями под одним именем, возникает путаница. Лучше использовать уникальные префиксы: company-code-review вместо просто code-review.
| Ошибка | Причина | Решение |
|---|---|---|
| Навык не активируется | Неверный путь к файлу | Проверь, что SKILL.md лежит в ~/.claude/skills/name/ |
| Claude игнорирует инструкции | Сломан YAML frontmatter | Валидируй YAML, проверь тройные дефисы |
| Навык срабатывает не в тех проектах | Лежит в личных навыках вместо проектных | Перенеси в .claude/skills/ внутри репозитория |
| Автоматическая активация не работает | Описание не соответствует задаче | Уточни случаи применения в description |
Если навык требует внешних данных (API-ключей, путей к файлам), их нельзя хранить в SKILL.md — репозиторий может быть публичным. Используй переменные окружения или ссылки на конфигурационные файлы, которые исключены из Git через .gitignore.
Чек-лист перед публикацией навыка в команде
Перед тем как закоммитить навык в репозиторий проекта, проверь следующие пункты:
- Файл SKILL.md содержит корректный YAML frontmatter с понятным description и корректными поддерживаемыми параметрами
- Инструкции написаны однозначно: Claude не должен угадывать, что делать в спорных ситуациях
- Примеры в навыке актуальны и соответствуют кодовой базе проекта
- Вспомогательные файлы (конфиги, шаблоны) лежат в той же директории и упомянуты в инструкции
- Навык протестирован на нескольких типовых задачах — проверь, что он не конфликтует с другими навыками
- В README проекта добавлено описание навыка: что делает, когда вызывать, какие зависимости требует
- Чувствительные данные (ключи, пароли, внутренние URL) вынесены в переменные окружения
Полезно добавить в навык раздел с ограничениями: какие задачи он не решает, когда лучше использовать другие инструменты. Это сэкономит время коллегам, которые впервые столкнутся с навыком в работе. Больше примеров настройки инструментов — в разделе проектов.
FAQ: частые вопросы о Skills для Claude
Можно ли использовать Skills в веб-версии Claude?
Это руководство относится к Claude Code. Нельзя переносить приведённые пути и команды в веб-интерфейс: возможности конкретного продукта и аккаунта нужно проверять отдельно.
Сколько навыков можно установить одновременно?
Устанавливайте только нужные навыки. Несколько пересекающихся инструкций затрудняют диагностику; после добавления нового навыка проверяйте, что прежние задачи выполняются корректно.
Можно ли продавать или распространять Skills?
Лицензирование зависит от условий, которые укажет автор навыка. Сам формат открытый, никаких технических ограничений на распространение нет. Рекомендуется использовать стандартные open source лицензии (MIT, Apache 2.0).
Как обновить навык до новой версии?
Замени содержимое директории навыка на новую версию файлов. Если навык был установлен через git clone, выполни git pull в папке навыка. После обновления проверьте, что в текущей сессии применяется новая версия; при сомнениях начните новую сессию.
Чем Skills отличаются от Custom Instructions?
Разовая инструкция действует в контексте текущего запроса. Файл навыка удобно отдельно проверять и хранить в системе контроля версий. Это не гарантия выполнения: оценивать нужно результат конкретного запуска.
Можно ли использовать Skills для работы с изображениями или аудио?
Одна инструкция не добавляет модели новые модальности. Для работы с изображением или аудио нужны соответствующие возможности выбранной среды и инструменты; навык может описывать порядок их использования.
Что делать, если готовый навык не подходит
Адаптация чужого навыка под собственные нужды — частая практика. Скопируй директорию навыка, переименуй её (например, code-review-custom) и отредактируй SKILL.md. Уточни description, добавь исключения для специфичных паттернов кодовой базы, приложи файл со стандартами компании.
Если навык срабатывает не к месту, уточните его description и сузьте задачу. Для ручного запуска документация предусматривает disable-model-invocation: true; проверьте поддержку параметра в вашей версии. Не используйте выдуманное поле triggers: удаление такого поля не является способом отключить автоматический вызов.
Для интеграции с CI/CD сначала определите, какие действия действительно нужны и какие права им потребуются. Сам навык не создаёт внешнее подключение и не делает скрипт надёжным: отдельно проверяются доступы, обработка ошибок и результат. Разборы рабочих процессов можно найти в разделе видео.
Skills для Claude расширяют возможности ИИ-ассистента за счёт структурированных инструкций, которые хранятся локально и активируются по команде или автоматически. Установка сводится к копированию файлов в нужную директорию, а создание собственного навыка требует только текстового редактора и базового понимания YAML. Проектные навыки синхронизируются через Git, что делает их удобным инструментом для командной разработки. Главное — следить за корректностью структуры SKILL.md и тестировать навыки на реальных задачах перед публикацией. Дополнительные материалы по автоматизации разработки доступны в разделе контактов для консультаций.