Agent Skills перешел под крыло Linux Foundation

Anthropic решила не держать стандарт 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, указав для каждого промпт и ожидаемый результат. Запусти все тесты и покажи их результаты, а также опиши выполненные действия.