# Как правильно писать скиллы для Claude Code: 7 типичных ошибок

# Как правильно писать скиллы для Claude Code: 7 типичных ошибок

> 7 ошибок при написании скиллов для Claude Code: нет триггера, дженерик имена, пустые секции, многословие. Чеклист хорошего скилла.

Source: https://okhlopkov.com/kak-pravilno-pisat-skilly-claude-code-7-oshibok/

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

