Agent Skills (как устроены)

Что делает

Скил — это папка с файлом SKILL.md (инструкции + опционально скрипты и справочные файлы), которая расширяет агента специализированным навыком. Модель сама подхватывает скил, когда задача совпадает с его описанием, — не нужно копипастить один и тот же чеклист в каждый чат.

Главное отличие от промта: progressive disclosure (поэтапная загрузка контекста):

• Уровень 1 — метаданные (name + description из YAML): всегда в контексте, ~100 токенов на скил. Поэтому можно держать десятки скилов без расхода контекста.
• Уровень 2 — тело SKILL.md: грузится, только когда скил сработал (<5k токенов).
• Уровень 3 — ресурсы и скрипты: читаются/исполняются по необходимости; код скрипта в контекст не попадает, только его вывод.

Это и отделяет скил от Промта (просто текст) и MCP (сервер-коннектор): скил — упакованный навык, который агент исполняет шагами.

Как поставить

Минимальный скил — два файла-«две части» в одном SKILL.md: YAML-фронтматтер и markdown-инструкции.

---
name: my-skill
description: Что делает и КОГДА применять. Первой — ключевая ситуация (триггер).
---

## Инструкции
Пошаговые указания, которым следует модель…

Куда класть зависит от площадки:

• Claude Code — ~/.claude/skills/<имя>/SKILL.md (личные, во всех проектах) или .claude/skills/<имя>/SKILL.md (проектные, в git).
• claude.ai (Pro/Max/Team/Enterprise) — загрузить zip в Settings → Features.
• Claude API — загрузить через /v1/skills, затем сослаться на skill_id в параметре container.

Обязательны только name (≤64 симв., строчные/цифры/дефисы, без слов «anthropic»/«claude») и description (≤1024 симв.).

Когда брать

• Один и тот же чеклист/процедуру вставляешь в чат раз за разом.
• Секция CLAUDE.md разрослась в процедуру, а не факт — вынеси в скил (грузится только при вызове).
• Нужен навык со скриптами (детерминированные операции), а не только текст.

Пример

В Claude Code: положил папку summarize-changes/ → спросил «что я изменил?» — модель сама подхватит скил по описанию, либо вызовешь напрямую /summarize-changes. Описание скила должно содержать слова, которые ты реально говоришь, иначе авто-триггер не сработает.