Скіли в Claude Code: як дизайнеру написати власний і не платити зайвого

Скіл — це ваша інструкція для Claude: що робити і як. Записана один раз у файл, а не надрукована вручну в кожній новій сесії. Якщо ви втретє пояснюєте Claude одну й ту саму процедуру (спочатку перевірити ієрархію, потім типографіку, потім контраст цифрами, і не хвалити), це вже не промпт, а скіл.

Важливо не плутати скіл із CLAUDE.md. Короткі постійні правила (наприклад, шрифт продукту або спейсинг 4/8pt) живуть у CLAUDE.md — він вантажиться щосесії, і однорядкові факти там на своєму місці. А от коли правило переросло в багатокрокову інструкцію, тримати її в CLAUDE.md означає платити за неї токенами в кожній розмові, навіть коли ви робите зовсім інше. Тому просто: покрокова інструкція йде в скіл, факт на один рядок лишається в CLAUDE.md.

Папка з файлом SKILL.md знаходиться у .claude/skills/ (проєктний) або ~/.claude/skills/ (особистий). Усередині YAML-фронтматер плюс сама інструкція. Той самий формат працює в Claude Code, у Claude.ai і через API — пишете один раз, а користуєтесь скрізь. І кожен скіл автоматично стає слеш-командою: папка design-critique дає команду /design-critique.

Найважливіше про скіли — це трирівневе підвантаження. Рівень 1 — name + description (близько 100 токенів на скіл, завжди в контексті). Claude знає, що скіл існує, але не знає змісту. Рівень 2 — тіло SKILL.md, яке вантажиться тільки коли скіл спрацював. Рівень 3 — довідники і скрипти, які підтягуються за потреби. Скрипти в контекст не потрапляють взагалі: Claude їх запускає, і в контекст іде тільки вивід, не код. Тому скілів може бути багато, платите тільки за той, що реально спрацював.

Однак є поширена помилка: люди пишуть SKILL.md на 800 рядків, туди і приклади, і референси, і кейси. Виглядає круто, а на практиці кожна активація з’їдає кілька тисяч токенів, скіл конкурує з вашою робочою розмовою, і через п’ять промптів Claude забуває код, з яким працював. Офіційна рекомендація — тримати тіло до 500 рядків, а краще до 200. Решту виносьте в окремі файли поруч.

Особливу увагу варто приділити description — це єдиний шанс скіла «продатися» Claude. Саме за description модель вирішує, підтягнути скіл чи ні. Тригерні слова ставте на початок опису, додавайте контртригери (наприклад, «Do NOT use for one-line responses»), щоб скіл не активувався на все підряд. І не забувайте про безпеку: description потрапляє в системний промпт, тому автор чужого скіла технічно може заховати туди що завгодно. Перед установкою проганяйте чужий SKILL.md через Claude в окремому чаті.

Свій перший скіл можна написати за 15 хвилин. Створіть папку в .claude/skills/, додайте файл SKILL.md із YAML-фронтматером та інструкцією. Потім протестуйте: 5 промптів, де скіл має активуватись, і 5, де не має. Активація 80%+ — це окей. Якщо менше — переписуйте description. І пам’ятайте: скіл без тестів — це чернетка.