Найти в Дзене
Даниил Охлопков

Как правильно писать скиллы для Claude Code

Спасибо чату за гайд: 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" в одном файле. Тут уж без обид. Короче: хороший скилл = понятное имя + когда вызывать + что делать + в каком формате отдавать. Не заполняйте контекст мусором, вам еще свои промпты докидывать.

Как правильно писать скиллы для Claude Code

Спасибо чату за гайд: 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" в одном файле. Тут уж без обид.

Короче: хороший скилл = понятное имя + когда вызывать + что делать + в каком формате отдавать.

Не заполняйте контекст мусором, вам еще свои промпты докидывать.