Спасибо чату за гайд: 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