Скилы = пакеты best practices. Устанавливаются, триггерятся, работают кросс-агентно.
Описание
Скиллы устанавливаются как пакеты (глобально или в проект), описывают, в каких случаях триггериться, и работают независимо от выбранного агента. Используются для специализированных задач, которые не должны раздувать AGENTS.md (см. UC-003 · AGENTS.md).
Предусловия
- Идентифицирована повторяющаяся задача со сформированными best practices
- Проверен источник скилла на доверенность (официальные публикаторы — Anthropic, Vercel, проверенные авторы)
Постусловия / гарантия успеха
- Скилл доступен агенту и автоматически (или явно) применяется по триггерам
- Снижается необходимость каждый раз объяснять одну и ту же методику
Основной сценарий
- Разработчик находит подходящий скилл (например, Vercel React best practices)
- Изучает риски, проверяет источник и список перезаписываемых файлов
- Устанавливает скилл глобально или в проект
- Перезапускает сессию агента, чтобы скилл подтянулся
- При необходимости явно вызывает скилл («проверь React-код проекта по best practices»)
Расширения / альтернативные потоки
- 5a. Если автоматический триггер скилла не сработал — разработчик называет скилл явно и фиксирует в notes, что описание триггера стоит улучшить
- 1a. Если подходящего публичного скилла нет — создаётся собственный скилл проекта
Исключения и риски
Бизнес-правила и ограничения
- Скиллы — это не магия, а упакованные инструкции и скрипты; их можно (и нужно) читать перед установкой
- Скиллы кросс-агентны: один скилл работает в большинстве современных агентов
Примечания
Хороший кандидат на скилл — задача, которая повторяется регулярно, но не настолько часто, чтобы быть в AGENTS.md (раз в неделю/месяц).
Частые вопросы
Чем скилл отличается от AGENTS.md?+
AGENTS.md — про базовый контекст проекта, читается всегда. Скилл — про специализированную методику, активируется по триггеру. AGENTS.md — что есть в проекте; скилл — как делать конкретную работу.
Откуда брать скиллы?+
Официальные от вендоров (Anthropic, Vercel), репозитории проверенных авторов. Перед установкой — читать содержимое: скилл может перезаписывать файлы и выполнять команды.
Можно ли написать свой скилл?+
Да, формат простой — текстовое описание триггеров + опционально скрипты. Если задача повторяется в проекте 3+ раза в неделю — пора оформлять в скилл.
Почему скилл от Vercel тянет Next.js?+
Скилл несёт стек своего автора. Это нормально, но важно понимать: применяя «React best practices от Vercel», вы получаете рекомендации в их экосистеме (Next, edge, etc). Если стек другой — фильтруйте.