Claude Code Skills: что это, как устроены и как создать свой навык

Skills — это система расширений для Claude Code, которая превращает агента из универсального инструмента в специалиста по конкретным задачам. Если CLAUDE.md рассказывает агенту правила одного проекта, то Skills — это библиотека многоразовых навыков, которые работают во всех ваших проектах: написание коммитов по стандартам компании, генерация отчётов, ревью кода, оформление документации.

По данным поисковых систем, в начале 2026 года около 2 300 человек в месяц ищут «claude code skills» в Яндексе — система ещё новая, но интерес быстро растёт. В этой статье разберём, что такое Skills, как они устроены, как создать свой первый навык за 10 минут, и какие готовые навыки уже доступны для скачивания.

Что такое Skills в Claude Code

Skills — это папки с инструкциями и вспомогательными файлами, которые Claude Code может подключать по требованию. Когда вы даёте задачу агенту, он сканирует доступные навыки и активирует подходящие. Если ни один не подходит — работает по общим знаниям.

Зачем нужны Skills

Главная проблема большого AI-агента: он знает всё, но не знает специфики вашей работы. Skills закрывают этот пробел:

• У вашей команды свои правила оформления коммитов — напишите навык commit, и Claude будет следовать им автоматически
• Вы регулярно делаете похожие отчёты — навык report оформит их единообразно
• Вы работаете с конкретной библиотекой, которая часто меняется — навык library-name хранит её актуальные правила использования

Без Skills вам пришлось бы каждый раз объяснять Claude эти детали заново. С Skills — один раз настроили, потом используется автоматически.

Skills против CLAUDE.md против Hooks

В Claude Code три механизма настройки. Каждый решает свою задачу:

Когда что использовать. Правила одного проекта (стек, команды, ограничения) — в CLAUDE.md. Многоразовые навыки (оформление кода, шаблоны, проверки) — в Skills. Жёсткие правила безопасности (проверка ключей, форматирование) — в Hooks.

Как устроен Skill: структура файлов

Каждый навык — это папка с обязательным файлом SKILL.md и любыми дополнительными файлами. Минимальная структура:

~/.claude/skills/
  commit-style/
    SKILL.md

Файл SKILL.md состоит из двух частей: метаданные в формате YAML (для Claude Code, чтобы понять, когда использовать навык) и описание самого навыка в формате Markdown.

Пример простого Skill

---
name: commit-style
description: Создание коммитов по стандарту Conventional Commits. Используй когда пользователь просит создать коммит, оформить изменения для Git или подготовить commit message.
---

# Стиль коммитов проекта

Используй формат Conventional Commits:
- feat: новая функциональность
- fix: исправление ошибки
- refactor: рефакторинг без изменения поведения
- docs: только документация
- test: только тесты
- chore: служебные изменения (зависимости, конфиги)

## Правила:

1. Заголовок не длиннее 72 символов
2. Описание в повелительном наклонении на русском («добавь», не «добавлен»)
3. Тело коммита через пустую строку, не обязательно
4. Один коммит — одно логическое изменение
5. Не указывай файлы в заголовке, описывай что сделано

## Примеры хороших коммитов:

feat: добавь форму подписки на рассылку
fix: исправь падение на пустом списке заказов
refactor: вынеси логику оплаты в отдельный модуль

Когда пользователь скажет «оформи коммит», Claude Code увидит в description слова «коммит», «commit», поймёт что нужен этот навык, и применит правила автоматически.

Поле description критически важно

Это самая важная часть навыка. Именно по description Claude решает, использовать навык или нет. Правила хорошего описания:

• Конкретно укажите триггер — какие слова или ситуации активируют навык
• Опишите контекст — для каких типов задач навык подходит
• Не дублируйте сам навык — description это сигнал «когда», а не «что делать»

Плохой description: «Помогает с коммитами». Это слишком общо — Claude не поймёт, в каких случаях применять.

Хороший description: «Создание коммитов по стандарту Conventional Commits. Используй когда пользователь просит создать коммит, оформить изменения для Git или подготовить commit message».

Как создать свой первый Skill за 10 минут

Пошаговая инструкция от создания до проверки.

Шаг 1. Выберите задачу

Лучшие навыки рождаются из повторяющихся задач. Что вы делаете 2-3 раза в неделю и приходится каждый раз объяснять Claude заново? Это и есть кандидат на Skill.

Примеры из реальной практики:

• Оформление документации README по корпоративному шаблону
• Написание тестов в формате, принятом в вашей команде
• Создание SQL-миграций с проверками безопасности
• Подготовка PR-описания по шаблону
• Генерация отчётов в одинаковом формате

Шаг 2. Создайте папку и SKILL.md

В терминале выполните:

mkdir -p ~/.claude/skills/my-first-skill
cd ~/.claude/skills/my-first-skill
touch SKILL.md

На Windows откройте Проводник, перейдите в папку C:\Users\ВашеИмя\.claude\skills\, создайте подпапку my-first-skill и в ней файл SKILL.md.

Шаг 3. Напишите метаданные

Откройте SKILL.md в любом текстовом редакторе. В самом начале добавьте YAML-блок между двумя строками с тремя дефисами:

---
name: my-first-skill
description: Краткое описание что делает навык. Используй когда пользователь просит [конкретный тип задач].
---

Имя навыка должно совпадать с именем папки. В description чётко укажите триггеры.

Шаг 4. Напишите содержимое навыка

После YAML — обычный Markdown с инструкциями. Структурируйте логично:

• Что делать
• Правила и ограничения
• Примеры
• Что НЕ делать

Чем конкретнее инструкции, тем лучше Claude будет следовать им.

Шаг 5. Проверьте навык

Запустите Claude Code в любом проекте и дайте задачу, которая должна активировать навык. Например, для навыка commit-style:

Создай коммит для текущих изменений.

Claude Code увидит навык, прочитает SKILL.md и применит правила. Если навык не сработал — проверьте, достаточно ли понятный description.

Где находятся Skills и какие бывают типы

Расположение

Skills хранятся в двух местах:

• Глобально: ~/.claude/skills/ (Linux/Mac) или C:\Users\ВашеИмя\.claude\skills\ (Windows). Доступны во всех проектах
• В проекте: .claude/skills/ в корне конкретного проекта. Доступны только в этом проекте

Глобальные навыки удобны для личных привычек (стиль коммитов, формат заметок). Проектные — для командных стандартов, которые коммитятся вместе с кодом.

Типы навыков по назначению

По классификации Anthropic, выделяют четыре основных типа:

1. Справочные навыки по библиотекам и API

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

2. Навыки проверки работы кода

Автоматизируют тестирование. Запускают браузерные сценарии, делают проверки через интерфейс командной строки, интеграционные проверки. Пример: после генерации формы навык автоматически проверяет, что она открывается и принимает ввод.

3. Навыки ревью кода

Проверяют код по корпоративным стандартам. Запускают самокритичные проверки, контролируют стиль, ищут типичные проблемы. Пример: после генерации API-эндпоинта навык проверяет, есть ли валидация ввода, обработка ошибок, проверки безопасности.

4. Навыки дизайна и оформления

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

Готовые Skills: где скачать

Не обязательно писать всё с нуля. Сообщество публикует готовые навыки на GitHub. Самые популярные источники:

awesome-claude-code-skills — главный сборник публичных навыков. Поиск на GitHub по этому названию покажет несколько активных репозиториев с сотнями навыков.

Anthropic Claude Cookbook — официальный репозиторий с примерами навыков от создателей Claude. Качество выше среднего, но не все универсальны.

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

Как установить чужой навык

1. Найдите репозиторий с навыком (или подборкой)
2. Скопируйте папку нужного навыка в ~/.claude/skills/
3. Прочитайте SKILL.md — поймёте, как он активируется
4. Запустите Claude Code и проверьте, как навык работает

Важно про безопасность. Skills могут содержать любые инструкции для агента. Если в навыке написано «удали все файлы в папке» — Claude может попытаться это сделать. Проверяйте навыки перед установкой. Доверяйте только проверенным источникам.

Топ-10 идей для Skills, которые повысят продуктивность

Конкретные навыки, которые стоит создать первыми. Все проверены на практике.

Каждый навык — это инвестиция: 30-60 минут на создание, экономия часов еженедельно.

Типичные ошибки при работе со Skills

Слишком общий description

Если в описании написано «помогает с задачами разработчика» — Claude не поймёт, когда использовать. Конкретизируйте.

Слишком много правил в одном навыке

Skill из 500 строк инструкций — это не навык, это документация проекта. Разбивайте на меньшие навыки по одному сценарию.

Дублирование с CLAUDE.md

Если правило применяется в одном проекте — оно в CLAUDE.md, не в Skills. Skills для многоразовых вещей.

Установка непроверенных навыков

Любой Skill — это инструкции, которые Claude будет следовать. Чужой навык может содержать вредоносные команды. Читайте код перед установкой.

Игнорирование description

Многие создают навык и ставят description «вспомогательный», «утилита». Claude не активирует такой навык. Description — это триггер, его нужно писать как поисковый запрос пользователя.

Полный пример: создание Skill для оформления документации

Покажем создание навыка с нуля на конкретном случае. Задача: единообразное оформление README-файлов в проектах.

Анализ задачи

Каждый раз когда вы начинаете новый проект и просите Claude Code создать документацию, агент пишет её по-разному: иногда подробно, иногда коротко, разная структура. Вы хотите единый шаблон: название, краткое описание, требования, установка, использование, лицензия.

Создание Skill

В терминале:

mkdir -p ~/.claude/skills/docs-readme
cd ~/.claude/skills/docs-readme

Создайте SKILL.md со следующим содержимым:

---
name: docs-readme
description: Создание README.md для проекта по корпоративному шаблону. Используй когда пользователь просит создать или обновить README, сделать документацию проекта, оформить описание репозитория.
---

# Шаблон README для проектов

Используй следующую структуру обязательно:

## 1. Название и краткое описание (3-5 строк)
- Что это за проект
- Какую задачу решает
- Кто может им пользоваться

## 2. Бейджи (если применимо)
- Версия
- Лицензия
- Статус сборки

## 3. Требования
- Операционная система
- Версии языка и зависимостей
- Внешние сервисы (база данных, очереди)

## 4. Установка
- Команды для установки зависимостей
- Настройка переменных окружения
- Первый запуск

## 5. Использование
- Основные команды
- Примеры запросов и ответов (если API)
- Скриншоты (если интерфейс)

## 6. Структура проекта
- Краткое описание ключевых папок и файлов

## 7. Разработка
- Как запустить тесты
- Как собрать релизную версию
- Правила оформления коммитов (ссылка на отдельный документ)

## 8. Лицензия
- Тип лицензии
- Год и автор

## Стиль письма:
- Заголовки в стиле «Установка», не «Как установить»
- Все примеры команд в кодовых блоках
- Без англицизмов в основном тексте (термины оставляй)
- Не используй эмодзи в README — только в маркетинговых текстах

Проверка

В тестовом проекте запускаем Claude Code:

Создай README для этого проекта.

Без Skill агент написал бы что-то общее. С Skill — точно следует структуре: восемь разделов, единый стиль, нужные акценты.

Как Skill влияет на качество вывода

Замеры на реальных проектах показывают конкретный выигрыш при использовании Skills.

Это не значит, что без Skills агент работает плохо. Но с настроенными Skills результат становится более предсказуемым и быстрее достигает финального вида.

Будущее Skills: куда движется экосистема

К середине 2026 года Anthropic активно развивает Skills как ключевую часть Claude Code. Видимые направления:

Магазин навыков. Готовится централизованный каталог проверенных навыков, по аналогии с App Store. Установка одной командой, обновления автоматические.

Командные навыки. Возможность подписки команды на общий набор навыков, синхронизация между всеми разработчиками автоматически.

Многошаговые навыки с состоянием. Сейчас навык — это инструкции. Будущее — навыки с памятью между запусками, способные накапливать опыт.

Интеграция с MCP. Skills и MCP-серверы будут работать вместе: навык вызывает функции внешнего сервиса через MCP.

Уже сейчас Skills — необязательная, но мощная часть экосистемы. Те, кто освоят их первыми, получат серьёзное преимущество в скорости работы.

Чеклист: создание первого Skill

1. Выберите повторяющуюся задачу — то, что вы объясняете Claude несколько раз в неделю
2. Создайте папку ~/.claude/skills/имя-навыка
3. Создайте файл SKILL.md в этой папке
4. Добавьте YAML-блок с полями name и description в самом начале файла
5. Напишите чёткое description — как поисковый запрос, по которому активируется навык
6. Опишите правила — что делать, что не делать, примеры
7. Запустите Claude Code и проверьте, активируется ли навык на тестовой задаче
8. Доработайте description, если навык не сработал
9. Поделитесь с командой — навык можно положить в репозиторий проекта в папку .claude/skills/
10. Создайте следующий навык — со временем у вас будет личная библиотека ускорителей