Как правильно писать скиллы для Claude Code: 7 типичных ошибок
7 ошибок при написании скиллов для Claude Code: нет триггера, дженерик имена, пустые секции, многословие. Чеклист хорошего скилла.
Как правильно писать скиллы для Claude Code
Спасибо чату за гайд: 7 типичных ошибок, из-за которых скилл не работает:
7 ошибок в скиллах
🔺 Нет триггера — Claude не понимает КОГДА вызывать скилл. Пиши "юзай, когда тебя просят задеплоить", а не "поможет при деплое".
🔺 Нет конкретных глаголов действий — "работает с файлами" это вода. Пиши create, generate, convert, analyze.
🔺 Дженерик имена — skill, helper, utils. Лучше: github-pr-reviewer, dev-browser.
🔺 Пустые секции — заголовок без контента жрёт токены впустую. Нет контента — удали секцию.
🔺 Многословные триггеры — "This skill should be used when the user wants to" → просто "Use when…" Каждый лишний токен стоит денег.
🔺 Нет формата вывода — скилл должен знать, что отдавать: json, md, plain text. С примером.
🔺 Противоречия — "always use TypeScript" и "support any language" в одном файле.
Формула хорошего скилла
Хороший скилл = понятное имя + когда вызывать + что делать + в каком формате отдавать.
Не заполняйте контекст мусором, вам еще свои промпты докидывать.
Оригинал: @danokhlopkov
Дан Охлопков — практик AI агентов. Строю инструменты для анализа TON Blockchain и автоматизации через Telegram.