# 05 — Skills

← [Главная](../README.md)

## Цель

Освоить **skills (навыки)** — структурированные workflow для агента; каталог ECC и создание собственных `SKILL.md`.

## Предварительно

- [04 — Rules](../04-rules/README.md)
- Понимание разницы rule vs one-shot prompt

## Время

**10–15 часов** на весь раздел

---

## Оглавление раздела

| Страница | Тема |
|----------|------|
| [Что такое skills](chto-takoe-skills.md) | SKILL.md, frontmatter, activation |
| [Когда использовать skill](kogda-ispolzovat-skill.md) | Триггеры, ECC catalog |
| [Создать skill](sozdat-skill.md) | Пошаговое создание своего навыка |

---

## Skill в одном предложении

**Skill** — markdown-инструкция с метаданными, которую агент **подключает**, когда задача совпадает с `description` в frontmatter.

Rules говорят «как жить всегда». Skills говорят «как **выполнить этот тип работы**».

---

## Где лежат skills

| Место | Путь | Область |
|-------|------|---------|
| Project | `.cursor/skills/<name>/SKILL.md` | Репозиторий |
| User | `~/.cursor/skills/<name>/SKILL.md` | Все ваши проекты |
| ECC | После install — сотни готовых | Зависит от install target |

**Не путать** с `~/.cursor/skills-cursor/` — служебные skills Cursor.

---

## Примеры skills в ECC

| Skill | Назначение |
|-------|------------|
| `tdd-workflow` | RED→GREEN→REFINE, 80% coverage |
| `django-patterns` | DRF, ORM, middleware |
| `configure-ecc` | Установка компонентов ECC |
| `code-tour` | CodeTour walkthroughs |
| `verification-loop` | Чеклист перед merge |
| `agent-sort` | Выбор subset ECC под проект |

Полный каталог — в репозитории ECC `.cursor/skills/`.

---

## Как агент «видит» skill

1. Cursor индексирует `description` skills.
2. При релевантном запросе skill попадает в контекст (или вы вызываете явно через `@`).
3. Агент следует шагам в теле `SKILL.md`.

Явный вызов: «Используй skill tdd-workflow для этой фичи».

---

## Практика раздела

1. Откройте `tdd-workflow/SKILL.md` в ECC (или установленной копии).
2. Прочитайте [когда использовать](kogda-ispolzovat-skill.md).
3. Создайте [свой минимальный skill](sozdat-skill.md).
4. Прогоните одну задачу с skill и одну без — сравните процесс.

---

## Skills vs agents

| | Skill | Agent (субагент) |
|---|-------|------------------|
| Формат | SKILL.md | Agent definition + Task |
| Запуск | В текущей сессии | Отдельный subprocess |
| Лучше для | Workflow, чеклисты | Изоляция, параллель |

Подробнее про agents — [раздел 06](../06-agents/README.md).

---

## Самопроверка

1. Чем skill отличается от rule?
2. Где хранится project skill?
3. Назовите два ECC skills по вашему стеку.
4. Как явно вызвать skill в промпте?

## Дальше

→ [Что такое skills](chto-takoe-skills.md)