Как использовать agent skills (SKILL.md) с Claude Code и другими агентами: пошаговое руководство

Agent skills — это пакеты инструкций в формате SKILL.md, которые подключаются к AI-агентам для программирования и расширяют их поведение: процесс работы, стандарты кода, шаблоны, проверки. Чтобы использовать навык в Claude Code или другом coding-агенте, нужно найти подходящий пакет, поместить его в папку навыков агента и проверить, что агент его подхватывает. Ниже — пошаговая инструкция.

Шаг 1. Найдите подходящий навык

Навыки собраны в каталоге Agent skills и в категории AI Skills. Перед установкой оцените три вещи: назначение, лицензию и издателя.

Некоторые пакеты, которые стоит посмотреть:

skills от издателя mattpocock — MIT-лицензия, навыки для инженерной работы вместо «vibe coding»: согласование задачи, общий язык и цикл red-green-refactor для тестов.
agent-skills от addyosmani — MIT-лицензия, библиотека production-инженерных навыков для этапов spec, plan, build, test, review и ship.
ui-ux-pro-max-skill — MIT-лицензия, навык с знаниями о дизайне для построения UI/UX на разных платформах и во фреймворках.
archify — MIT-лицензия, навык для превращения идеи, плана или кодовой базы в интерактивную диаграмму; описан как навык для Claude Code, Codex и других агентов.
marketingskills — MIT-лицензия, маркетинговые навыки для Claude Code и AI-агентов: CRO, копирайтинг, SEO, аналитика.
scientific-agent-skills — MIT-лицензия, набор из 177 навыков для научных задач, совместимый с Cursor, Claude Code и Codex.
notebooklm-py — MIT-лицензия, неофициальный Python API и агентский навык для Google Gemini Notebook.

Если нужен не один навык, а оркестрация нескольких агентов, посмотрите ruflo, который описан как агентский harness с роями агентов и нативной поддержкой Claude Code и Codex, и paperclip — открытое приложение для управления агентами. Для образовательных сценариев есть DeepTutor с лицензией Apache-2.0.

Шаг 2. Проверьте лицензию и источник

Навык — это текст, который влияет на поведение агента и на код, который он пишет. Прежде чем установить пакет:

проверьте лицензию в карточке продукта;
откройте издателя и убедитесь, что это ожидаемый автор;
прочитате SKILL.md целиком и убедитесь, что в нем нет неожиданных команд.

Навык — это инструкция, а не код. Но если он предлагает запускать скрипты, проверяйте их так же, как любой сторонний код.

Шаг 3. Установите навык

Общая схема для Claude Code такая:

Склонируйте репозиторий навыка или скачайте нужную папку.
Скопируйте папку навыка в каталог навыков агента. Для проекта это обычно папка .claude/skills/ в корне репозитория, для всех проектов пользователя — каталог навыков в домашней директории.
Убедитесь, что в папке есть файл SKILL.md.
Перезапустите сессию агента, чтобы он загрузил навык.

Для других агентов путь может отличаться, поэтому сверяйтесь с документацией конкретного инструмента. Пакеты вроде agent-skills и skills удобно подключать целиком, а отдельные навыки из большого набора, как в scientific-agent-skills, — выборочно, чтобы не перегружать контекст агента.

Шаг 4. Проверьте, что навык работает

После перезапуска попросите агента описать, какие навыки он видит, или дайте задачу, которая должна активировать навык. Например, для skills попросите агента сначала уточнить требования, а не сразу писать код. Если поведение не изменилось, проверьте путь к папке и наличие SKILL.md.

Шаг 5. Напишите собственный навык

Свой навык — это папка с файлом SKILL.md. Файл состоит из заголовка с метаданными и инструкций.

Структура

Имя навыка и короткое описание, по которому агент решает, когда его применять.
Пошаговый процесс: что делать, в каком порядке, какие проверки пройти.
Ограничения: чего агент не должен делать.
Ссылки на вспомогательные файлы внутри папки, если они нужны.

Практические советы

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

Хороший ориентир для собственных навыков — подход из agent-skills: явные этапы spec, plan, build, test, review.

Шаг 6. Поддерживайте набор навыков

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