Agent Skills перешел под крыло Linux FoundationAnthropic решила не держать стандарт Agent Skills при себе и передала его Linux Foundation — тому же фонду, которому ранее достался MCP.
Цифры впечатляют: с запуска в октябре прошлого года опубликовали 1 миллион скиллов, а установили их почти 280 миллионов раз. Сегодня стандарт поддерживают более 70 платформ для ИИ-агентов, среди них ChatGPT, Cursor, GitHub Copilot и VS Code.
За год сложился единый подход к созданию скиллов, и официальное руководство по разработке тоже ушло фонду. Вот шесть самых полезных правил из него.
• Сначала пройдите задачу вместе с агентом. В скилл превращайте только то, что реально сработало: ваши исправления, форматы входных и выходных данных, дополнительный контекст. Если модель пишет скилл на общих знаниях, получится набор бесполезных советов вроде «обрабатывайте ошибки надлежащим образом».
• Проверяйте каждую строку. Спросите себя: ошибся бы агент без этой инструкции? Если нет — удаляйте.
• Особое внимание — описанию скилла. При запуске агент видит только название и описание, так что именно от описания зависит, будет ли скилл вообще использован. Пишите в духе «Используй этот скилл, когда...», делайте формулировку настойчивой, перечисляйте ситуации, которые пользователи могут не называть прямо, и укладывайтесь в 1024 символа.
• Не раздувайте
SKILL.md. Держите его в пределах 500 строк и 5000 токенов, а детали выносите в каталог
references/, указывая, когда агенту читать каждый файл.
• Разделяйте строгие инструкции и рекомендации. Там, где легко ошибиться, давайте точные команды. Где нужно самостоятельное решение — объясняйте причины выбора. Если задачу можно решить несколькими способами, предлагайте один вариант по умолчанию.
• Составляйте список типичных ошибок (gotchas). Во многих скиллах именно он оказывается самым полезным. Каждый раз, когда приходится исправлять ошибку агента, добавляйте замечание в этот список.
И главное: сразу после того, как агент закончит задачу, которую вы часто ему поручаете, отправьте следующий промпт в Claude Code в рамках той же сессии — так успешный подход сохранится как стандартный скилл.
Промпт для Claude Code:
Следуя руководству
https://agentskills.io/skill-creation/best-practices, преврати задачу, которую мы только что выполнили, в скилл.
Используй исключительно те шаги, которые успешно сработали в этой сессии, мои исправления, а также связанные с ними решения из файлов
CLAUDE.md,
AGENTS.md и истории Git. Не восполняй пробелы общими знаниями.
Сформулируй описание в формате «Используй этот скилл, когда...». Включи ситуации, которые я не упоминал напрямую, но в которых скилл должен активироваться. Длина описания не должна превышать 1024 символа.
Ограничь размер
SKILL.md 500 строками. Подробную информацию вынеси в каталог
references/, указав, в каких случаях агенту следует обращаться к каждому файлу.
Выдели отдельный раздел с типичными ошибками и подводными камнями.
Для названия скилла используй только строчные латинские буквы, цифры и дефисы. Название должно совпадать с именем каталога.
В завершение создай 2–3 реальных тестовых сценария в файле
evals/evals.json, указав для каждого промпт и ожидаемый результат. Запусти все тесты и покажи их результаты, а также опиши выполненные действия.