Ты уже видел, как Claude Code подхватывает CLAUDE.md и slash-команды. Skill (навык) — третий способ дать агенту знание. По сути это всего лишь папка с одним обязательным файлом внутри — SKILL.md. Никакой магии: обычный текст с шапкой-фронтматтером и инструкциями.
Из чего состоит навык
Минимальный Skill выглядит так:
.claude/skills/
otchet-po-shablonu/
SKILL.md
Папка задаёт имя навыка по смыслу, а вся суть — в SKILL.md. У файла две части: фронтматтер (шапка между ---) и тело с инструкциями.
---
name: otchet-po-shablonu
description: Собирает отчёт о проделанной работе по нашему внутреннему шаблону — когда просят подвести итоги спринта или оформить changelog.
---
# Как оформлять отчёт
1. Заголовок: что сделано за период.
2. Список изменений по разделам: фичи, баги, документация.
3. В конце — что осталось и риски.
name и description
name — короткое имя навыка. description — самое важное поле: по нему Claude решает, нужен ли навык прямо сейчас. Об этом — следующий урок.
Прогрессивное раскрытие
Claude не держит в голове все навыки целиком. В контексте постоянно живёт только короткое description каждого навыка. Полное тело SKILL.md агент читает лишь тогда, когда задача совпала с описанием. Так десятки навыков не засоряют контекст: подгружается ровно тот, что сейчас к месту.
Заметка
Папка может содержать и другие файлы — примеры, шаблоны, скрипты. Но SKILL.md обязателен: это вход в навык.
Практика в терминале