Готовые скилы экономят время, но настоящий кайф начинается, когда делаешь свой. Под свою задачу, под свой стиль, под свои грабли. Я за последний месяц собрал четыре штуки — и на каждом наступил на что-то новое. Покажу весь процесс с реальным примером и всеми ошибками.
С чего вообще начинается скил
Смотрите, скил — это не программа и не плагин в привычном смысле. Это папка с текстовым файлом SKILL.md внутри. Да, просто папка и текст.
SKILL.md — инструкция для модели на человеческом языке. Русском или английском — без разницы. Вы описываете: кем Claude должен стать, что делать, чего не делать, как оформлять результат. Скил не заменяет мозги модели — он направляет их. Разница как между «напиши мне письмо» и «напиши письмо в стиле нашей компании, без канцеляризмов, до 150 слов».
Когда скил, а когда промт? Скил оправдан, если задача повторяется 5+ раз в месяц, есть устойчивый workflow и нужны файлы-подсказки. Для разовых задач хватит промта. А в браузере без CLI есть Projects в claude.ai — облегчённый аналог.
🔩 Анатомия — что внутри скила
В начале SKILL.md — блок между двумя ---. Это frontmatter (шапка с метаданными — как тема и адрес в письме):
- name — имя в kebab-case (слова-через-дефис, например tg-post-generator). По нему вызываете скил командой /tg-post-generator
- description — что делает и когда применять. Самая важная часть: Claude по ней решает, подключать скил или нет
После второго --- — body: инструкции, ограничения, формат вывода.
Рядом можно положить папки examples/ (образцы результата), templates/ (шаблоны), scripts/ (код), references/ (справочники). Но обязателен только SKILL.md.
Пять шагов — и скил работает
Шаг 1. Конкретная задача. Не «помоги с контентом», а «пост для Telegram-канала про AI в моём стиле». Чем уже — тем точнее.
Шаг 2. Опишите свой workflow. Как ВЫ делаете эту задачу? У меня для постов: хук с цифрой → суть в абзац → цитата с примером → призыв. Плюс правила: без буллетов, 400-700 знаков, 2-3 хэштега.
Шаг 3. Создайте папку. Скилы живут в двух местах:
- ~/.claude/skills/имя-скила/ — личные, работают везде
- .claude/skills/имя-скила/ — проектные, только здесь
Внутри — SKILL.md. Никакой установки. Claude находит скилы автоматически.
Шаг 4. Напишите SKILL.md. Frontmatter с name и description, body с ролью, workflow, ограничениями, форматом. Есть примеры — в examples/, ссылка из body.
Шаг 5. Тестируйте. Запросите задачу — Claude подхватит скил сам или вызовите /имя-скила. Правки в SKILL.md подхватываются без перезапуска.
Пример — генератор TG-постов
Вот упрощённый SKILL.md:
---
name: tg-post-generator
description: Создаёт пост для Telegram-канала про AI-инструменты в стиле автора. Использовать когда просят написать пост или драфт для Telegram.
---
Ты — генератор постов для Telegram-канала (тематика: AI-инструменты).
Стиль: короткие абзацы по 2-3 предложения, эмодзи в начале ключевых абзацев (🔥 💡 ⚡), в конце 2-3 хэштега.
Структура:
- Хук — конкретика или цифра
- Суть в одном абзаце
- Цитата с примером или промтом
- Призыв к действию
Ограничения: 400-700 знаков, не выдумывать факты, не использовать «друзья» и «в современном мире».
Под свой канал — замените тематику, стиль и структуру.
Пишу Claude «сделай пост про новую фичу в Gemini» — он видит совпадение с description, подключает инструкции, выдаёт пост в нужном формате. Честно говоря, я раньше каждый раз вставлял стиль-гайд руками — копипаста на 20 строк. Сейчас — ноль лишних действий.
🪤 Где я собрал все грабли
Каждый пункт стоил мне от получаса до целого вечера. Ну, вы знаете это ощущение.
Размытое description. Первый раз написал «Помогает с контентом» — и Claude ни разу не подключил скил. Ни разу. Переписал на «Создаёт пост для Telegram-канала про AI когда просят написать пост» — заработало сразу. Вывод простой: description — это не аннотация для человека, это триггер для модели.
Перегруз инструкций. Хм, тут я отличился. 1800 строк в SKILL.md — это я серьёзно. Модель начала путаться и выдавать кашу. Откатил до 200-400 строк, остальное вынес в examples/ и references/. Стало нормально.
Нет примеров. Один файл-образец в examples/ дал больше, чем три абзаца объяснений. Модели проще «увидеть», чем «прочитать описание стиля».
Edge cases (крайние случаи). Скил для постов работал на новостях, но на длинных гайдах — каша. Добавил правило «если сложная тема — разбей на серию», починилось.
Захардкоженные данные. Вписал имя канала намертво, потом хотел использовать для другого проекта — пришлось менять руками. Сразу делайте параметры гибкими.
И что, теперь всё?
Готовый скил можно выложить на GitHub (удобно версионировать), поделиться в community-чатах Claude Code, или подсмотреть паттерны в Anthropic Cookbook. Официального маркетплейса пока нет — но, думаю, вопрос времени.
Это финал серии «Прокачка Claude»: 1) что такое скилы и где брать, 2) агенты и как сделать своего, 3) как написать свой скил. Три статьи дополняют друг друга — рекомендую читать по порядку.
———
📲 Посты и фишки между статьями — в моём Телеграме: @skazhi_ai