Как создать скилл для Клода и куда его установить

Свой скилл — это папка с текстовым файлом, и первый рабочий вариант собирается за полчаса. Разбираем структуру, установку и то, из-за чего скиллы чаще всего не подхватываются.

Короткий ответ

Нужны два шага: создать папку с файлом SKILL.md и положить её туда, где Клод её увидит. Никакого кода, никакой сборки — обычный текст в разметке Markdown.

Дальше агент сам решает, когда скилл применить: он читает описания всех доступных скиллов и подключает подходящий.

Шаг 1. Структура

Минимальный скилл выглядит так:

otchet-po-prodazham/
  SKILL.md

Если нужны шаблоны, справочники или скрипты — кладите рядом:

otchet-po-prodazham/
  SKILL.md
  shablon-otcheta.md
  scripts/
    svesti-tablicy.py

Шаг 2. Заголовок файла

В начале SKILL.md — блок с названием и описанием:

---
name: otchet-po-prodazham
description: Собирает недельный отчёт по продажам из выгрузки в наш формат. Использовать, когда просят подготовить отчёт или свести данные из таблицы продаж.
---

Описание — самая важная строка во всём скилле. По нему и только по нему агент решает, подключать скилл или нет. Полный текст он до этого не читает.

Плохое описание: «помогает с отчётами». Непонятно, с какими и когда.

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

Шаг 3. Тело скилла

Дальше — обычный текст. Работает такая структура:

## Что делаем

Собираем недельный отчёт по продажам из выгрузки CRM.

## Порядок

1. Проверить, что в выгрузке есть колонки: дата, менеджер, сумма, статус.
2. Отфильтровать отменённые сделки.
3. Сгруппировать по менеджерам, посчитать сумму и количество.
4. Оформить по шаблону shablon-otcheta.md.

## Правила

- Суммы округляем до рублей, разряды разделяем пробелом.
- Менеджеров сортируем по сумме, а не по алфавиту.
- Если данных за неделю нет — так и пишем, а не показываем нули.

## Чего не делать

- Не додумывать пропущенные значения.
- Не менять формулировки в шапке отчёта.

Раздел «чего не делать» недооценивают, а он экономит больше всего времени: агент склонен добавлять от себя, и явный запрет работает лучше просьбы.

Шаг 4. Куда положить

Здесь чаще всего и спотыкаются, потому что мест несколько.

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

В Claude Code — папка со скиллами в проекте или в пользовательской конфигурации. Разница как с настройками MCP: проектные уезжают в репозиторий к команде, пользовательские остаются у вас.

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

Шаг 5. Проверить, что подключился

Не полагайтесь на то, что файл лежит в правильном месте — проверьте на деле.

1. Спросите, какие скиллы доступны.
2. Дайте задачу словами из описания — той самой строки, которая определяет срабатывание.
3. Посмотрите, применились ли ваши правила. Если агент сделал по-своему — скилл не подключился либо описание не совпало с формулировкой задачи.

Почему скилл не срабатывает

Пять причин по частоте:

1. Размытое описание. «Помогает с текстами» не срабатывает никогда, потому что не содержит условия. Опишите ситуацию, в которой скилл нужен.

2. Скилл лежит не там. Приложение и Claude Code читают скиллы из разных мест. Положили в одно — проверяете в другом.

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

4. Скиллов слишком много и они пересекаются. Два скилла с похожими описаниями — агент выберет не тот. Разводите по условиям срабатывания.

5. Инструкция противоречива. В одном месте «пиши коротко», в другом развёрнутый пример на страницу. Агент следует примеру, а не декларации.

Как писать, чтобы работало

• Примеры сильнее правил. Один разобранный случай «было — стало» заменяет абзац объяснений.
• Конкретика вместо оценок. Не «пиши хорошо», а «абзац не длиннее четырёх строк, без вводных слов».
• Порядок шагов явно. Нумерованный список выполняется точнее, чем описание в прозе.
• Одна задача — один скилл. Универсальный скилл на всё срабатывает невпопад.
• Дописывайте по факту. Первая версия всегда неполная; правила добавляются, когда агент ошибся.

Готовые скиллы как основа

Быстрее, чем писать с нуля: взять близкий готовый и переделать под себя. Где искать — в обзоре источников.

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

Если нужно не знание, а доступ

Скилл объясняет, как делать. Если агент не может дотянуться до нужных данных — это другая задача, и решается она через MCP: как создать свой MCP-сервер.

Аналог скиллов у OpenClaw — навыки, и там своя механика: создание собственных навыков.

Коротко

Папка, файл SKILL.md, внятное описание с условием срабатывания — этого достаточно для рабочего скилла. Основное время уходит не на структуру, а на формулировку правил, и она уточняется по ходу. Начните с задачи, которую объясняете чаще всего, — что такое скиллы и когда они нужны.