Редакция 20 августа 2026 г.

Claude Skills: папка с инструкциями вместо бесконечного копипаста промптов

Третий раз за неделю вы объясняете агенту одно и то же: как оформить PR, какие файлы трогать, куда смотреть в репозитории. В Cursor это часто живёт в rules; у Claude тот же смысл упакован иначе — в папку skill с файлом SKILL.md. Для соло-разработчика на агентном стеке это не «ещё один формат ради формата», а способ не платить контекстом за каждый повтор и не терять инструкции между сессиями.

Папка вместо промпта: что такое Claude Skill

Claude Skill — каталог с entry point SKILL.md: YAML-frontmatter плюс Markdown-инструкции и опциональные ресурсы (скрипты, шаблоны, справочники). Формат задуман как повторяемый набор правил: не разовая реплика в чате, а упаковка, которую агент подхватывает по описанию задачи.

По сравнению с обычным промптом skill живёт вне диалога и подгружается по требованию. На старте сессии для каждого установленного skill в контексте остаются только name и description — порядка ~100 токенов на skill; полный SKILL.md читается, когда запрос совпадает с description. Это progressive disclosure: метаданные дешёвые, тело — только при срабатывании.

Anthropic позиционирует skill как reusable folder on demand; prompt — разовую инструкцию в разговоре. Для vibe coding, где вы гоняете одни и те же workflow через агента, разница практическая: skill можно закоммитить в репозиторий, отдать команде или поставить из каталога — промпт придётся копировать заново.

Три поверхности — и ловушка несинхронизации

Skills работают не «везде одинаково», а на трёх поверхностях Anthropic плюс у других агентов, которые читают тот же SKILL.md:

Поверхность	Куда класть skill	Кто пользуется	Ограничение runtime
Claude Code	`~/.claude/skills/<name>/` или `.claude/skills/<name>/` в репо; также plugin и enterprise managed settings	Вы, один проект или аудитория плагина	Сетевой доступ как у любой программы на машине
claude.ai	Zip в Settings → Features; нужны Pro/Max/Team/Enterprise и включённый code execution	Индивидуальный аккаунт	Сеть зависит от настроек пользователя и админов
Claude API	`skill_id` в параметре `container` + beta `skills-2025-10-02`; либо upload через `/v1/skills`	Весь workspace	Sandbox без сети и без установки пакетов в runtime

Custom skills не синхронизируются между поверхностями: zip на claude.ai не появится в API, API-skill не откроется в веб-интерфейсе, файловые skills Claude Code живут отдельно.

Если вы настраиваете агентный workflow в IDE и параллельно гоняете API-контейнеры — закладывайте отдельные пути установки, а не ожидайте «один архив на всё».

Другие продукты подключаются через свой install path к той же папке; showcase перечислен на agentskills.io — формат заявлен как open standard, не только для Claude.

Установка без package manager: от slash-команды до `npx skills add`

В спецификации skills нет единого package manager — путь зависит от поверхности.

Claude Code — самый близкий соло-сценарию к «положил в репо и забыл»:

Личные skills: ~/.claude/skills/<name>/SKILL.md
Проектные: .claude/skills/<name>/ — можно закоммитить, чтобы вся команда в одном codebase получила одинаковые инструкции
Claude Code отслеживает каталоги и подхватывает новый или изменённый SKILL.md в текущей сессии, без рестарта
Вызов: slash-команда по имени каталога или автозагрузка при совпадении запроса с description
Frontmatter disable-model-invocation: true оставляет skill только для ручного триггера — уместно для deploy, commit, отправки писем

claude.ai: zip → Settings → Features; каждый teammate грузит свой аккаунт — skills per user, не org-wide.

Claude API: skill внутри code execution container; при работе с файлами — заголовок files-api-2025-04-14.

Из каталогов без ручной сборки папки:

npx skills add owner/repo

/plugin marketplace add anthropics/skills

Перед публикацией skill стоит прогнать skills-ref validate ./my-skill — reference library из экосистемы формата.

Анатомия `SKILL.md`: frontmatter, лимиты и цена лишних строк

Обязательная модель — директория с SKILL.md. Frontmatter по Agent Skills specification:

Поле	Обязательно	Смысл
`name`	Да	До 64 символов; lowercase, цифры, дефисы; должен совпадать с именем родительской папки
`description`	Да	До 1024 символов; формулировка словами пользователя — что делает skill и когда его звать
`license`, `compatibility`, `metadata`, `allowed-tools`	Нет	Лицензия, окружение, мета, pre-approved tools (experimental)

Рекомендуемая структура каталога:

my-skill/
  SKILL.md
  scripts/      # опционально
  references/   # опционально
  assets/       # опционально

Стадии загрузки и бюджет контекста:

Стадия	Когда	Что в контексте
Metadata	Старт	`name` + `description` (~100 токенов/skill)
Instructions	Запрос совпал с description	Тело `SKILL.md` (<5000 токенов рекомендуется)
Resources	По ссылке из skill	Файлы и output скриптов, не весь каталог сразу

Spec рекомендует держать SKILL.md короче 500 строк; детали — в references/. В Claude Code тело triggered skill остаётся в сессии — каждая лишняя строка в main file становится recurring cost.

Claude Code принимает дополнительные поля frontmatter (disable-model-invocation, argument declarations). Пути claude.ai upload, Skills API и packaging script Anthropic допускают только шесть полей spec — неожиданный ключ даёт hard error. Skill, заточенный под IDE-агента с расширенным frontmatter, может не перенестись на API без правки.

Команда без единого реестра: git, plugin, каталоги

Формат портируемый, но distribution per surface — единого team registry в spec нет.

Поверхность	Как шарится
claude.ai	Per user; админы не управляют централизованно
Claude API	Uploaded skills — workspace-wide
Claude Code	Личная папка → репозиторий → plugin → org managed settings

Практики из гайда для командной работы:

Закоммитить .claude/skills/ — если все в одном codebase
Plugin marketplace или managed settings — шире аудитории
Каталоги: anthropics/skills, community obra/superpowers, skills.sh

Автор поста продвигает Skills Board — searchable каталог с install command, ZIP и MCP endpoint для поиска библиотеки (не security review и не установка внутри агента). Рекомендация «какой skill для задачи X» по-прежнему часто живёт в чате, а не в самом формате — это ограничение дизайна, не баг вашего репо.

Для соло-разработчика, который уже ведёт rules в Cursor, переносимый паттерн тот же: версионируемые инструкции рядом с кодом, а не в истории чата. Прямого утверждения «Cursor rules = Claude Skills» в первоисточнике нет; в блоке «Keep reading» у того же автора есть отдельная статья про Cursor skills с путями установки и двумя дополнительными frontmatter-полями Cursor — это соседний материал, не паритет полей внутри primary.

Open standard, MCP и безопасность: что не смешивать

Формат выпущен как open standard; спецификация на agentskills.io. Skills с frontmatter сверх шести полей spec и body-фичами только Claude Code не переносятся в другие агенты — при кросс-платформенном skill закладывайте минимальный common denominator.

Skill и MCP — разные слои. Skill — папка инструкций и ресурсов; MCP — протокол подключения к внешним tools и данным. В гайде их часто комбинируют (пример: MCP endpoint Skills Board для поиска team library), но подменять MCP skill'ом нельзя: один не заменяет другой.

По безопасности Anthropic рекомендует ставить skills только из доверенных источников, аудировать bundled files и осторожно относиться к external URL внутри skill — «как к установке ПО». Pre-built skills Anthropic (PowerPoint, Excel, Word, PDF) доступны на claude.ai и API, но не в Claude Code — ещё один повод сверять поверхность перед ожиданиями.

Источники

Claude Skills: what they are and how to use them — основной гайд; дата доступа при обогащении: 2026-08-20 (UTC). На странице: «Published August 12, 2026»; в метаданных Dev.to API: 2026-08-18T13:18:13Z.
Спецификация Agent Skills и client showcase: agentskills.io (упоминается в первоисточнике).
Метаданные Dev.to: оценка времени чтения ~15 мин, тег devtools (по данным платформы).