Чтобы создать skill для Claude, нужно создать одну папку с одним файлом внутри: файл SKILL.md, который начинается с названия и описания, а затем содержит инструкции на понятном языке. Заархивируйте папку, загрузите её в Claude (или поместите в ~/.claude/skills/ для Claude Code), и Claude будет загружать её всякий раз, когда запрос соответствует описанию. Никакого кода, SDK или этапа сборки.
На этой странице
- Что нужно подготовить
- Шаг 1: Выберите одну задачу и определите, что значит «готово»
- Шаг 2: Создайте папку и файл SKILL.md
- Шаг 3: Напишите frontmatter (часть, которая определяет, когда навык активируется)
- Шаг 4: Пишите инструкции как метод, а не как настроение
- Шаг 5. Добавьте один пример готового результата
- Шаг 6. Упакуйте и установите его
- Шаг 7. Протестируйте его по-настоящему
- Бесплатный шаблон Skill для Claude (скопируйте и адаптируйте)
- Пять ошибок, из-за которых Skill становится бесполезным
- Пусть Claude подготовит первый черновик
- Создать свой 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, который пытается охватить «всё, что делает маркетинг-менеджер», получает расплывчатое описание, срабатывает не в те моменты и выдаёт общие ответы даже при срабатывании.
Сначала напишите два предложения:
- Триггер: «Используйте этот skill, когда кто-то просит X или передаёт Y».
- Результат: «Результат - это 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 не нужна предыстория. Ему нужны шаги, правила и целевой формат. Структура, подходящая для большинства деловых навыков:
- Входные данные - что предоставит пользователь и что нужно запросить, если данных не хватает (максимум два вопроса, затем продолжить, явно указав допущения).
- Рабочий процесс - пронумерованные шаги в порядке, в котором их выполнил бы внимательный специалист.
- Формат вывода - точные разделы, заголовки, объём и тон.
- Правила - то, что всегда должно или никогда не должно происходить («никогда не выдумывать сумму бюджета; писать „не обсуждалось“»).
- Проверка качества - краткий список, по которому 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, который опробовали лишь один раз, нельзя считать протестированным. Выполните эту проверку, прежде чем делиться им с командой:
- Проверка срабатывания (5 prompts). Напишите пять запросов, которые должны запускать Skill, сформулировав их по-разному. Посчитайте, сколько из них сработало. Если меньше четырёх, в описании нужно использовать больше реальных формулировок пользователя.
- Проверка молчания (5 prompts). Напишите пять похожих запросов, которые не должны его запускать. Если он срабатывает хотя бы на одном, сузьте описание.
- Проверка отсутствующих входных данных. Дайте ему половину входных данных. Он должен задать короткий вопрос или озвучить свои допущения, а не выдумывать факты.
- Тест формата. Сравните три результата бок о бок с примером. Те же разделы, тот же диапазон длины, тот же тон?
- Тест граничных случаев. Передайте ему самые неаккуратные реальные входные данные: сбивчивую расшифровку, почти пустую таблицу.
Исправьте 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 до конца дня.