Гайд для новичка

Как сделать скилл
в Claude Code

Скиллы — это инструкции, которые учат Клода выполнять задачи правильно. Разберём с нуля.

1 Стандартный визард 2 Готовый скилл 3 Кастомизация
Зачем это нужно

Skills — это способ превратить ИИ в набор
специализированных продуктовых ассистентов

😩 Без Skills

Каждый раз пишешь вручную:

«проанализируй фидбек пользователей, выдели проблемы, предложи гипотезы, структурируй по приоритетам...»

→ Результат каждый раз разный. Трата времени.

✨ Со Skills

Просто говоришь:

«используй skill: user-feedback-analysis»
И ИИ сам:
анализирует данные
структурирует выводы
предлагает гипотезы
📦
Skill = готовый бизнес-процесс, упакованный для ИИ
шаблон задачи чек-лист автоматизированный ассистент сохранённая роль
Зачем это продакту
🤖
Убирает рутину

Не нужно писать одно и то же много раз — просто зови скилл по имени.

🎯
Предсказуемый результат

ИИ работает по сценарию, а не «как получится» каждый раз.

Ускоряет процессы

Анализ фидбека, PRD, гипотезы, отчёты — быстро и по шаблону.

🤝
Стандарты для команды

Один скилл — единый формат задач, анализа и гипотез на всю команду.

Что такое скилл?

Скилл — это папка с файлом SKILL.md внутри. Когда ты просишь Клода что-то сделать, он заглядывает в список скиллов и, если находит подходящий, читает инструкцию из него.

Это как дать коллеге чек-лист: «Когда делаешь презентацию — вот шаги». Без скилла Клод справляется сам, но со скиллом — по твоим правилам.

Структура скилла
my-skill/
  SKILL.md← обязательно
  scripts/ ← опционально
  references/ ← опционально
  assets/ ← опционально
Часть 01

Используем встроенный визард

Самый простой способ — попросить Клода создать скилл за тебя
Диалог с Клодом
Ты
Хочу создать скилл, который будет помогать делать красивые отчёты в Word. Каждый раз одинаковые шаги, хочу автоматизировать.
Claude
Отлично! Давай разберёмся. Что именно входит в этот процесс? Какие шаги ты обычно делаешь, какой формат нужен на выходе?
Ты
Заголовок, оглавление, таблицы с данными, страницы нумеруются. Вот пример файла...
Claude
Понял. Создаю скилл word-report/SKILL.md. Запускаю тестовые кейсы, проверяю результат, итерируем...
📌 Ключевая идея

Визард — это сам скилл skill-creator. Он уже установлен в Claude Code. Просто опиши задачу — Клод сам проведёт интервью, напишет SKILL.md, протестирует и поправит.

1

Скажи, что хочешь автоматизировать

Опиши задачу своими словами. Не нужно знать технические термины — Клод сам разберётся. Можно кинуть пример файла или рассказать о типичном рабочем процессе.

"Сделай скилл для создания Excel-отчётов по продажам. Каждый месяц одно и то же — хочу автоматизировать."
2

Ответь на вопросы визарда

Клод уточнит детали: какой формат на выходе, какие данные на входе, в каких случаях скилл должен срабатывать. Чем точнее ответишь — тем лучше результат.

Клод спросит

  • Когда использовать?
  • Что на входе?
  • Что на выходе?
  • Особые требования?

Хорошо ответить

  • Дать пример файла
  • Описать шаги
  • Назвать исключения
  • Указать формат
3

Проверь тестовые запуски

Визард запустит скилл на тестовых примерах и покажет результаты. Посмотри — всё ли правильно? Если нет, скажи что не так — Клод поправит и попробует снова.

💡 Совет

Не ищи идеал с первого раза. Нормально делать 2–3 итерации. Визард специально создан для этого цикла: черновик → тест → правка.

4

Получи готовый .skill файл

Когда доволен результатом — попроси упаковать. Клод создаст файл .skill, который можно установить.

"Всё выглядит хорошо, упакуй скилл"

→ Клод создаст my-skill.skill
Часть 02

Добавить готовый скилл

Кто-то уже написал скилл — просто установи его
Как выглядит установка скилла
ШАГ 1 📦 my-skill.skill Получить файл от коллеги ШАГ 2 ⚙️ Claude Code Settings → Skills → Install ШАГ 3 Скилл активен Клод автоматически применяет его ИЛИ через чат: "Установи скилл из файла X" Клод сделает сам
1

Получи файл .skill

Попроси коллегу поделиться, скачай из репозитория или найди в маркетплейсе скиллов. Это обычный файл — можно передавать как документ.

2

Установи через UI или чат

Два способа на выбор:

Через интерфейс

  • ⚙️ Settings
  • → Skills
  • → Install from file
  • → Выбрать .skill

Через чат

"Установи скилл из файла /path/to/my.skill"
3

Проверь, что скилл работает

После установки просто напиши запрос, который должен его активировать. Если в описании скилла написано «для Excel-отчётов» — попроси создать Excel-отчёт и смотри, применяется ли скилл.

⚠️ Важно

Скилл срабатывает только на подходящие запросы. Простые однострочные задачи могут не триггерить его — нужен более конкретный или сложный запрос.

Часть 03

Кастомизация скилла

Правим SKILL.md руками — это проще, чем кажется
Из чего состоит SKILL.md
SKILL.md --- name: excel-reporter description: Создаёт Excel-отчёты. Используй когда просят отчёт, таблицу или xlsx. --- ## Шаги работы 1. Прочитай входные данные 2. Создай структуру таблицы 3. Сохрани в /outputs/ ## Важные правила - Заголовки жирным, числа с разрядами FRONTMATTER — «шапка» скилла Зона между двумя --- . Клод читает её при каждом запросе и решает: «Этот запрос для моего скилла?» Здесь только name и description. description — КЛЮЧЕВОЕ ПОЛЕ По нему Клод находит нужный скилл. Пиши подробно, включай ключевые слова. ТЕЛО — твои инструкции для ИИ Обычный текст: шаги, правила, примеры.
📋 Два главных поля

name — идентификатор скилла, одно слово через дефис.
description — самое важное! По нему Клод решает, когда применять скилл. Пиши подробно: что делает скилл И когда его использовать.

1

Улучши описание (description)

Это самый частый способ кастомизации. Если скилл не срабатывает когда надо — расширь description. Включи туда конкретные фразы, которые ты обычно пишешь.

❌ Плохо

description: Создаёт отчёты.

Слишком коротко — Клод не поймёт, когда включаться

✅ Хорошо

description: Создаёт Excel-отчёты. Используй когда просят отчёт, таблицу, аналитику, xlsx.
2

Добавь конкретные инструкции в тело

После frontmatter (после второго ---) — обычный Markdown. Пиши сюда всё: шаги, правила, примеры, ограничения.

## Правила форматирования - Заголовки: жирный шрифт 14pt - Числа: формат #,##0.00 - Шапка таблицы: синий фон (#1a56db) ## Обязательная структура файла Лист 1: Сводная таблица Лист 2: Детали по менеджерам Лист 3: Графики
3

Добавь вспомогательные файлы

Если инструкций много — вынеси их в отдельные файлы рядом со SKILL.md. Это удобно для больших скиллов.

excel-reporter/
  SKILL.md← главный файл
  references/
    formatting-rules.md ← детали
    examples.md ← примеры
  assets/
    template.xlsx ← шаблон

В SKILL.md укажи когда читать эти файлы: «Если нужны детали форматирования — читай references/formatting-rules.md»

4

Попроси Клода оптимизировать description

Есть специальный инструмент для автоматической оптимизации — он тестирует разные варианты описания и выбирает лучший. Доступен в Claude Code.

Ты
Мой скилл excel-reporter не всегда срабатывает. Можешь оптимизировать его description?
Claude
Запущу optimization loop — он протестирует разные варианты и покажет какой лучше. Займёт пару минут...

🔑 Главные правила кастомизации

Description — важнее всего По нему Клод решает когда применять скилл. Пиши подробно и конкретно.
Тело — обычный Markdown Просто пиши инструкции как обычный текст. Никакого специального синтаксиса.
Итерации — норма Первая версия редко идеальна. Тестируй, правь description, тестируй снова.
SKILL.md до 500 строк Длинные детали выноси в references/. Так скилл загружается быстрее.
SOS

Мини-шпаргалка: если ничего не работает

Пройди по списку сверху вниз — одно из этого точно поможет
🔇
Скилл вообще не срабатывает

Расширь description — добавь конкретные слова, которые ты обычно пишешь в запросах. Клод ищет совпадение именно там.

📝
Запрос слишком простой

Скиллы не триггерятся на однострочники вроде «сделай отчёт». Попробуй сформулировать задачу конкретнее и подробнее.

💥
Ошибка в SKILL.md — скилл не читается

Проверь, что оба --- на месте и между ними нет лишних пробелов или русских кавычек. Frontmatter чувствителен к форматированию.

🔄
Отредактировал скилл, но ничего не изменилось

Начни новый чат — Клод подхватывает обновлённые скиллы только в новой сессии.

🤷
Не понимаешь, применил ли Клод скилл

Спроси напрямую: «Ты использовал скилл excel-reporter для этого?» — Клод честно ответит.

⚙️
Результат есть, но не тот

Добавь конкретный пример нужного результата прямо в тело SKILL.md — покажи Клоду как должно выглядеть «правильно».

🧹
SKILL.md вырос до 500+ строк

Вынеси детали в папку references/ и оставь в SKILL.md только ссылку на них. Тяжёлые файлы замедляют работу скилла.

🤝

Универсальный совет: опиши проблему Клоду прямо в чате — «мой скилл X не работает, вот SKILL.md». Он сам найдёт что не так и предложит правку.

CLAUDE CODE SKILLS

Создавай, устанавливай, кастомизируй — учи Клода работать по своим правилам.