Скиллы по версии Anthropic
Внутри Anthropic в активном ходу сотни скиллов. Thariq из команды Claude Code собрал, что из этого реально работает. В Главе 01 мы узнали, что такое скилл. Здесь — как писать их хорошо и держать в порядке на масштабе.
Что отличает хороший скилл
Скилл — это папка, а не markdown-файл: внутри скрипты, ассеты, справочники, которые агент открывает по мере надобности. Это и есть прогрессивное раскрытие. Из девяти советов Thariq четыре стоит запомнить дословно, остальные — держать в уме.
- Description — для модели. В начале сессии Claude строит листинг всех скиллов по их описаниям и сканирует его. Значит description — это условие срабатывания, а не резюме.
- Секция Gotchas — самый ценный контент. Собирай туда места, где Claude спотыкается, и дописывай по мере новых граблей.
- Не загоняй в рельсы. Скилл переиспользуем: давай цель и ограничения, а не жёсткий пошаговый скрипт. Иначе сломается на первом нестандарте.
- Не говори очевидного. Claude и так много знает. Ценность — там, где скилл выталкивает модель из дефолта (классика: frontend-design против шрифта Inter и фиолетовых градиентов).
| Правило | Суть |
|---|---|
| Прогрессивное раскрытие | Файловая система как контекст: ссылайся на references/api.md, агент прочитает в нужный момент. |
| Продумай setup | Контекст от пользователя храни в config.json; нет конфига — спроси через AskUserQuestion. |
| Память и данные | Логи/JSON/SQLite в скилле; для стабильности — папка ${CLAUDE_PLUGIN_DATA} (переживает апдейт). |
| Храни скрипты | Дай Claude код — он тратит ходы на композицию, а не на переписывание бойлерплейта. |
| On-demand хуки | Хуки, живущие только пока скилл активен (Глава 05): /careful, /freeze. |
Чекин против плагина
Поделиться скиллом с командой можно двумя путями, и выбор зависит от масштаба.
Чекин в репо
Положить под .claude/skills и закоммитить. Просто, но каждый скилл немного добавляет в контекст модели.
Плагин + маркетплейс
Свой Claude Code marketplace: команда сама выбирает, что установить. Контекст не раздувается у всех сразу.
Без центрального комитета. Полезные скиллы находят органически: заливают в sandbox-папку на GitHub, кидают ссылку в Slack. Набрал тягу — PR на перенос в маркетплейс. Курирование до релиза важно, чтобы не плодить дубликаты.
Скиллы, которые зовут скиллы
Композиция: один скилл может зависеть от другого (скилл генерации CSV зовёт скилл загрузки файла). Менеджмента зависимостей пока нет, но достаточно сослаться на другой скилл по имени — модель вызовет его, если он установлен.
Измерение: чтобы понять, как скилл живёт, повесь PreToolUse-хук, который логирует использование. Так видно популярные скиллы и те, что недотриггерятся против ожиданий.
“Большинство наших скиллов начинались как пара строк и одна gotcha, и становились лучше, потому что люди дописывали их, когда Claude натыкался на новые края.
Шесть тезисов на вынос
- Description пиши для модели как условие срабатывания, не как резюме.
- Gotchas — самое ценное; дописывай по мере граблей. Скилл растёт от «пары строк».
- Не загоняй в рельсы и не повторяй очевидное: цель и ограничения, ценность сверх дефолта.
- Скилл — папка: прогрессивное раскрытие, скрипты, config.json, ${CLAUDE_PLUGIN_DATA}, on-demand хуки.
- Distribution: чекин для малых команд, плагин-маркетплейс для масштаба; курирование органическое.
- Композиция по имени, измерение через PreToolUse-лог.