Как создать Skill для Claude (пошаговое руководство с бесплатным шаблоном)

8 мин чтения KissMySkills

Чтобы создать skill для Claude, нужно создать одну папку с одним файлом внутри: файл SKILL.md, который начинается с названия и описания, а затем содержит инструкции на понятном языке. Заархивируйте папку, загрузите её в Claude (или поместите в ~/.claude/skills/ для Claude Code), и Claude будет загружать её всякий раз, когда запрос соответствует описанию. Никакого кода, SDK или этапа сборки.

На этой странице
  1. Что нужно подготовить
  2. Шаг 1: Выберите одну задачу и определите, что значит «готово»
  3. Шаг 2: Создайте папку и файл SKILL.md
  4. Шаг 3: Напишите frontmatter (часть, которая определяет, когда навык активируется)
  5. Шаг 4: Пишите инструкции как метод, а не как настроение
  6. Шаг 5. Добавьте один пример готового результата
  7. Шаг 6. Упакуйте и установите его
  8. Шаг 7. Протестируйте его по-настоящему
  9. Бесплатный шаблон Skill для Claude (скопируйте и адаптируйте)
  10. Пять ошибок, из-за которых Skill становится бесполезным
  11. Пусть Claude подготовит первый черновик
  12. Создать свой Skill или начать с готового?

Таков весь механизм. Skill, который срабатывает каждый раз и выдаёт результат, готовый к использованию, отличается от skill, который никогда не запускается, примерно шестью решениями, и в этом руководстве они рассматриваются по порядку. В конце вы найдёте бесплатный шаблон для копирования и контрольный список для проверки skill перед началом использования.

Если вы впервые сталкиваетесь с этой концепцией, начните со статьи Что такое Claude Skills?, а затем вернитесь сюда. Предполагается, что вы уже знаете, что такое skill, и хотите создать его.

Что нужно подготовить

  • Учётная запись Claude с включённым выполнением кода. Skills работают на тарифах Free, Pro, Max, Team и Enterprise, но параметр выполнения кода и создания файлов должен быть включён. В Team и Enterprise администратору может потребоваться сначала включить skills для организации.
  • Текстовый редактор. Любой редактор, который сохраняет обычный текст: VS Code, TextEdit в режиме обычного текста, Notepad.
  • Одна повторяющаяся задача. Не «маркетинг». Что-то вроде «преобразовывать расшифровку звонка с клиентом в заметку CRM в нашем формате» или «проверять договор на наличие пяти стандартных тревожных сигналов». Чем уже задача, тем лучше skill.
  • Два или три реальных примера хорошего результата. Прошлые отчёты, письма и брифы, которые вы были бы готовы отправить. Это лучший исходный материал для skill.

Шаг 1: Выберите одну задачу и определите, что значит «готово»

Большинство неудачных skill терпят неудачу именно здесь, ещё до написания первой строки. Skill, который пытается охватить «всё, что делает маркетинг-менеджер», получает расплывчатое описание, срабатывает не в те моменты и выдаёт общие ответы даже при срабатывании.

Сначала напишите два предложения:

  1. Триггер: «Используйте этот skill, когда кто-то просит X или передаёт Y».
  2. Результат: «Результат - это Z с такими разделами, такого объёма и в таком стиле».

Пример: «Используйте этот skill, когда кто-то вставляет расшифровку звонка с клиентом и просит составить заметки. Результат - заметка в CRM с разделами "Краткое содержание", "Проблемные моменты", "Бюджет", "Следующий шаг" и "Риски", объёмом менее 200 слов, написанная для менеджера по продажам, который не участвовал в звонке». Если вы не можете написать эти два предложения, разделите задачу на два skill.

Шаг 2: Создайте папку и файл SKILL.md

Skill - это папка, имя которой совпадает с именем skill. Единственный обязательный файл внутри неё - SKILL.md (имя файла чувствительно к регистру). Дополнительные файлы помещаются рядом с ним:

Путь Обязательно? Для чего это нужно
call-notes/SKILL.md Да Frontmatter и инструкции, которым следует Claude
call-notes/resources/example-output.md Рекомендуется Готовый пример результата
call-notes/resources/style-guide.md Необязательно Дополнительные справочные материалы, которые Claude читает только при необходимости
call-notes/scripts/ Необязательно Скрипты Python или shell для шагов, требующих точности, например для разбора CSV

Папку следует называть строчными буквами, используя дефисы, например call-notes или quarterly-report. Та же строка указывается в название поле на следующем шаге.

Шаг 3: Напишите frontmatter (часть, которая определяет, когда навык активируется)

Файл начинается с короткого блока YAML между двумя строками из трёх дефисов. Обязательны два поля:

  • name - строчные буквы, цифры и дефисы, не более 64 символов. Это становится идентификатором, а в Claude Code - командой со слешем (/call-notes).
  • description - до 1 024 символов. Это единственная часть, которую Claude читает в начале сеанса для каждого установленного навыка. Она решает, будет ли навык загружен вообще.

Пишите описание так, будто объясняете коллеге, который должен за одну секунду решить, относится ли запрос к его задаче. Сначала укажите, что создаёт навык, затем перечислите ситуации и фразы, которые должны его активировать. Сравните:

  • Слабый вариант: «Помогает с заметками о продажах».
  • Сильный вариант: «Преобразует расшифровку звонка по продажам или знакомству с клиентом в структурированную заметку для CRM (Резюме, Проблемы, Бюджет, Следующий шаг, Риск) объёмом менее 200 слов. Используйте, когда пользователь вставляет расшифровку звонка, текст записи встречи или черновые заметки по звонку и просит составить заметки, резюме, запись в CRM или итоговое резюме для последующего контакта».

Сильная версия называет входные данные, результат и слова, которые люди действительно вводят. Именно это обеспечивает надёжный запуск и отсутствие срабатываний в остальных случаях.

Шаг 4: Пишите инструкции как метод, а не как настроение

Всё ниже блока frontmatter - это Markdown, которому Claude следует после загрузки навыка. Распространённая ошибка - длинное описание персоны («Вы всемирно известный эксперт по продажам с 20-летним опытом...»), но отсутствие процедуры. Claude не нужна предыстория. Ему нужны шаги, правила и целевой формат. Структура, подходящая для большинства деловых навыков:

  1. Входные данные - что предоставит пользователь и что нужно запросить, если данных не хватает (максимум два вопроса, затем продолжить, явно указав допущения).
  2. Рабочий процесс - пронумерованные шаги в порядке, в котором их выполнил бы внимательный специалист.
  3. Формат вывода - точные разделы, заголовки, объём и тон.
  4. Правила - то, что всегда должно или никогда не должно происходить («никогда не выдумывать сумму бюджета; писать „не обсуждалось“»).
  5. Проверка качества - краткий список, по которому Claude проходит перед ответом.

Стремитесь к тому, чтобы он умещался на одном-двух экранах. Если файл получается длиннее примерно 500 строк, перенесите справочные материалы (длинные руководства по стилю, прайс-листы, тексты политик) в файлы в resources/ и укажите в SKILL.md, когда Claude должен их открывать. Подробнее о структуре файла см. в статье Что такое файл SKILL.md?

Шаг 5. Добавьте один пример готового результата

Пример быстрее любого описания объясняет формат. Поместите один реалистичный, завершённый результат в resources/example-output.md и укажите на него ссылку в рабочем процессе («сопоставьте структуру и длину с ресурсом resources/example-output.md»). Возьмите реальный фрагмент прошлой работы, изменив имена и числа, а не шаблон, заполненный скобками. Наш собственный каталог следует тому же правилу: каждый Skill поставляется с примером результата, поскольку это самый наглядный признак того, что его действительно протестировали.

Шаг 6. Упакуйте и установите его

В Claude (веб-версия и приложение для компьютера): заархивируйте папку так, чтобы сама папка находилась в корне архива (call-notes.zip содержит call-notes/SKILL.md). Откройте раздел Skills в настройках, загрузите архив и включите Skill. Начните новый чат и отправьте запрос, соответствующий описанию.

В Claude Code: архив не нужен. Поместите папку в ~/.claude/skills/, чтобы использовать её во всех проектах, или в .claude/skills/ внутри репозитория, чтобы поделиться ею со всеми, кто работает с этим репозиторием. Введите /call-notes или просто опишите задачу. Claude Code подхватит изменения в папке без перезапуска.

Полное пошаговое руководство для каждой платформы, включая расположение файлов и действия в случае отклонения загрузки, приведено в статье Как установить Claude Skill. Разработчикам, которые в основном работают в терминале, также стоит прочитать Skills для Claude Code.

Шаг 7. Протестируйте его по-настоящему

Skill, который опробовали лишь один раз, нельзя считать протестированным. Выполните эту проверку, прежде чем делиться им с командой:

  1. Проверка срабатывания (5 prompts). Напишите пять запросов, которые должны запускать Skill, сформулировав их по-разному. Посчитайте, сколько из них сработало. Если меньше четырёх, в описании нужно использовать больше реальных формулировок пользователя.
  2. Проверка молчания (5 prompts). Напишите пять похожих запросов, которые не должны его запускать. Если он срабатывает хотя бы на одном, сузьте описание.
  3. Проверка отсутствующих входных данных. Дайте ему половину входных данных. Он должен задать короткий вопрос или озвучить свои допущения, а не выдумывать факты.
  4. Тест формата. Сравните три результата бок о бок с примером. Те же разделы, тот же диапазон длины, тот же тон?
  5. Тест граничных случаев. Передайте ему самые неаккуратные реальные входные данные: сбивчивую расшифровку, почти пустую таблицу.

Исправьте description, если есть проблемы со срабатыванием, а workflow или rules - если есть проблемы с выводом. Внизу файла ведите краткий журнал изменений, чтобы знать, какую версию использует ваша команда.

Бесплатный шаблон Skill для Claude (скопируйте и адаптируйте)

Замените части, написанные ЗАГЛАВНЫМИ БУКВАМИ, удалите ненужное и сохраните файл под именем SKILL.md в папке с таким же названием, как у название поле.

---
name: название-вашего-skill
description: Создаёт КОНКРЕТНЫЙ РЕЗУЛЬТАТ (разделы, длина) из КОНКРЕТНЫХ ВХОДНЫХ ДАННЫХ. Используйте, когда пользователь ПРОСИТ X, ВСТАВЛЯЕТ Y или упоминает Z. Не используйте для ПОХОЖЕЙ ЗАДАЧИ, КОТОРАЯ ОТНОСИТСЯ К ДРУГОМУ МЕСТУ.
---

# НАЗВАНИЕ ВАШЕГО SKILL

## Назначение
Одно или два предложения: для кого это предназначено и как выглядит результат, когда задача выполнена.

## Входные данные
- Обязательно: ЧТО ПОЛЬЗОВАТЕЛЬ ДОЛЖЕН ПРЕДОСТАВИТЬ
- Необязательно: ЧТО УЛУЧШАЕТ РЕЗУЛЬТАТ
- Если обязательные входные данные отсутствуют, задайте не более двух коротких вопросов,
  затем продолжите и перечислите свои допущения в начале вывода.

## Рабочий процесс
1. Прочитайте входные данные и определите КЛЮЧЕВЫЕ ЭЛЕМЕНТЫ.
2. Сверьте его с ПРАВИЛАМИ ИЛИ КРИТЕРИЯМИ.
3. Подготовьте вывод в формате ниже.
4. Выполните проверку качества, исправьте всё, что ей не соответствует, затем ответьте.

## Формат вывода
- Раздел 1: НАЗВАНИЕ - ЧТО ЗДЕСЬ ДОЛЖНО БЫТЬ (длина)
- Раздел 2: НАЗВАНИЕ - ЧТО ЗДЕСЬ ДОЛЖНО БЫТЬ (длина)
- Раздел 3: НАЗВАНИЕ - ЧТО ЗДЕСЬ ДОЛЖНО БЫТЬ (длина)
Сопоставьте структуру и длину с resources/example-output.md.

## Правила
- Никогда не выдумывайте цифры, имена или даты. Вместо этого пишите «не предоставлено».
- Используйте простой английский. Не добавляйте пустых вступлений.
- ПРАВИЛО, СПЕЦИФИЧНОЕ ДЛЯ ВАШЕЙ КОМАНДЫ ИЛИ ОТРАСЛИ.

## Проверка качества
- Все разделы присутствуют и расположены в правильном порядке?
- Каждое утверждение можно отследить до исходных данных?
- В пределах ограничения длины?

## Журнал изменений
- v1.0 ПЕРВАЯ ВЕРСИЯ, ДАТА

Хотите увидеть, как выглядят готовые Skill? В статье Примеры Skill для Claude построчно разобраны двенадцать реальных файлов SKILL.md - это самый быстрый способ понять, сколько деталей достаточно.

Пять ошибок, из-за которых Skill становится бесполезным

  • Описание, в котором указано, что представляет собой Skill, а не когда его использовать. «Экспертный копирайтер» никогда не срабатывает. А «Пишет текст для страницы товара на основе списка характеристик, когда пользователь просит описание товара, текст для PDP или текст объявления» - срабатывает.
  • Один Skill на весь отдел. Бюджетирование, расчёт зарплат и аудит в одном файле дают три неполных ответа. Создайте три Skill.
  • Нет формата вывода. Без него каждый запуск выглядит по-разному, и ему никто не доверяет.
  • Секреты в файле. Никогда не вставляйте ключи API, пароли или данные клиентов в Skill. Любой, с кем вы им поделитесь, сможет их прочитать.
  • Установка чужого Skill без прочтения. Skill содержит инструкции, которым будет следовать Claude, а иногда и скрипты. Прочитайте его так же, как прочитали бы скрипт перед запуском.

Пусть Claude подготовит первый черновик

Не обязательно начинать с пустого файла. Claude может расспросить вас о задаче, подготовить frontmatter и рабочий процесс, создать пример результата и предложить приведенные выше тестовые prompts. Anthropic поставляет встроенный Skill-creator Skill именно для этого, а можно также попросить обычными словами: «Проведи со мной интервью о том, как я пишу наш еженедельный отчет для клиента, а затем создай для этого SKILL.md». Черновик потребует ваших правок, особенно описания и правил, но избавит от большей части набора текста.

Предпочитаете форму чату? Бесплатный Claude Skill Builder превращает краткое описание задачи в готовый SKILL.md с frontmatter и рабочим процессом, который можно скопировать или скачать в формате .zip для Claude.ai и Claude Code. Регистрация не требуется.

Хотите, чтобы собеседование, самопроверка и упаковка были выполнены за вас? Claude Skill Creator ($19) — это Skill, который создает Skills: он спрашивает о задаче, запросах, которые люди действительно вводят, и о том, чего ни в коем случае не должно происходить, создает полную папку Skill с файлом SKILL.md и примером результата, проверяет описание на запросах, которые должны и не должны его запускать, и упаковывает папку для Claude, Claude Code и API. Чтобы проверить написанный или загруженный Skill, используйте Claude Skill Reviewer & Security Linter или получите оба инструмента, а также Skills для проверки prompt, MCP и кода, в составе Build Your Own Claude Skills Kit ($49).

Создать свой Skill или начать с готового?

Создайте свой Skill, если рабочий процесс уникален для вашей команды, содержит внутренние знания, которых ни у кого за пределами команды нет, или вам нравится дорабатывать результат. Начните с готового Skill, если задача относится к стандартной роли (ведение бухгалтерии, SEO-брифы, проверка контрактов, ответы службы поддержки), а послеобеденное время вы предпочли бы потратить на работу, а не на составление инструкций. Готовый Skill из нашей библиотеки Skills для Claude стоит $19, поставляется с примером результата и представляет собой обычный файл Markdown, который можно открыть и отредактировать, поэтому он также подойдет как шаблон для собственной версии.

В любом случае следующий шаг один и тот же: выберите одну задачу, которую вы повторяете каждую неделю, напишите два предложения из шага 1 и создайте рабочий Skill до конца дня.

Часто задаваемые вопросы

Do I need to know how to code to create a Claude skill?+

No. A skill is a Markdown file with a short header containing a name and a description, followed by instructions in plain language. Scripts are optional and only needed when a step must be computed exactly, such as parsing a file.

What is the minimum a Claude skill needs?+

One folder containing a file named SKILL.md. The file must start with YAML frontmatter that has a name (lowercase letters, numbers and hyphens) and a description of up to 1,024 characters. Everything after that is your instructions.

Why does my Claude skill never trigger?+

Almost always because of the description. Claude reads only the name and description of each installed skill to decide whether to load it. Rewrite the description to lead with the deliverable and include the exact words people use when they ask for that task.

How do I install a skill I created?+

In Claude on the web or desktop, zip the skill folder and upload it in the skills section of your settings, then switch it on. In Claude Code, place the folder in ~/.claude/skills/ for all projects or .claude/skills/ inside a repository. Code execution must be enabled on your account.

Can Claude write a skill for me?+

Yes. Anthropic provides a built-in skill-creator skill, and you can also ask Claude to interview you about a task and draft the SKILL.md. Treat the draft as a starting point and edit the description, rules and example output yourself before relying on it.