Как правильно писать скиллы для 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" в одном файле. Тут уж без обид.

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

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

В этом посте были ссылки, но мы их удалили по правилам Сетки