# Анатомия Skill: папка и SKILL.md

Курс: Агенты, субагенты и Skills — https://zero2claude.ru/learn/agents
Канонический URL: https://zero2claude.ru/learn/agents/3-1-anatomiya-skill

Skill — это папка с файлом SKILL.md, у которого во фронтматтере есть name и description. Что куда кладётся и зачем нужно каждое поле.

Ты уже видел, как 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` обязателен: это вход в навык.

**Практика в терминале.** `. Здесь ты тренируешь саму структуру — а настоящий Claude Code подхватит такую папку из твоего проекта." />