Skills: повторяемые знания и рабочие процедуры

Краткий ответ

Skill — повторно используемая инструкция или процедура, которую Claude Code загружает по необходимости. CLAUDE.md содержит короткий всегда актуальный контекст, а Skill подходит для подробного workflow: выпуск релиза, миграция схемы, проверка доступности или подготовка отчёта.

Где хранится Skill

Проектный Skill находится в .claude/skills/<skill-name>/SKILL.md и доступен этому репозиторию. Личный — в ~/.claude/skills/<skill-name>/SKILL.md и применяется во всех проектах пользователя. Skill также может поставляться плагином.

В каталоге разрешены вспомогательные шаблоны, примеры, справочные файлы и скрипты. Обязательной точкой входа остаётся SKILL.md.

Что написать в SKILL.md

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

Skill может быть справочным или выполнять действие. Процедуры с внешними эффектами следует проектировать особенно осторожно и не полагаться только на текстовую просьбу о подтверждении.

Отличие от CLAUDE.md, MCP и subagent

CLAUDE.md: короткие правила, нужные в каждом сеансе.
Skill: знания или workflow, загружаемые по ситуации.
MCP: новый инструмент для внешней системы.
Subagent: отдельный исполнитель с изолированным контекстом.
Hook: автоматическая реакция на событие.

Если команда каждый раз вручную вставляет один и тот же многошаговый prompt, это кандидат на Skill.

Жизненный цикл навыка

Создайте первую версию из реально повторившегося процесса. Проверьте её на двух разных задачах. Зафиксируйте входы и выходы, добавьте негативные сценарии, затем обновляйте по результатам review. Проектный Skill должен версионироваться вместе с кодом и проходить обычный code review.

Практика: каркас Skill

---
name: api-review
description: Проверяет изменения публичного API перед pull request.
---

# API review

1. Определи изменившиеся публичные контракты.
2. Проверь обратную совместимость.
3. Найди или добавь контрактные тесты только по явному запросу.
4. Верни замечания с файлами и сценариями сбоя.

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

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

Skill загружается целиком при каждом старте?

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

Можно ли положить в Skill исполняемый скрипт?

Да, каталог может содержать scripts и другие вспомогательные файлы. Их назначение и безопасный способ запуска нужно описать в SKILL.md.

Когда процедура должна стать hook, а не Skill?

Когда она обязана автоматически срабатывать на конкретное событие и не должна зависеть от решения модели, например форматирование после редактирования.

Что важно запомнить

Skill хранит повторяемую процедуру, а не постоянный фон проекта.
Один каталог имеет обязательный SKILL.md и необязательные ресурсы.
Проектные Skills следует рецензировать как код.
Выбирайте между Skill, MCP, subagent и hook по механизму задачи.

https://yadro-code.ru/lessons/without-university/claude-code-workflows/claude-code-11