.claude/skills/ — что это и зачем

Почему это важно именно вам

Каждую неделю вы делаете одно и то же. Открываете Claude, пишете «проверь это письмо на тон и ошибки, учитывая что получатель — внешний партнёр, поэтому нужно соблюдать формальность, но без канцелярита» — и так раз пять в неделю. Или «разбери этот договор: найди риски для нашей стороны, обрати внимание на штрафные санкции и сроки». Или «составь недельный отчёт по следующим данным в формате для руководства: сначала итог, потом детали».

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

Фаза 4 курса начинается с самого практичного инструмента для директора, который работает с Claude каждый день. Skills — это способ зафиксировать отработанный процесс и вызывать его одной командой. Написали /ревью-письма, приложили текст — и через минуту получили разбор именно по тем критериям, которые вы однажды выбрали. Без повторного объяснения контекста, без разночтений, без «а в этот раз он почему-то решил сосредоточиться на стиле, а не на рисках».

Если посчитать: пять задач в неделю, по минуте объяснений каждая — это пять минут чистого «шума» еженедельно. За год — четыре с лишним часа, которые вы потратили только на повторение одного и того же. Skills убирают этот шум полностью.

Что это такое

Представьте, что у вас есть секретарь. Умный, но новый — каждый раз приходит без памяти о предыдущих разговорах. Чтобы он сделал что-то правильно, нужно каждый раз объяснять с нуля: как писать отчёты в вашей компании, на что обращать внимание в договорах, каким тоном отвечать партнёрам.

Теперь представьте, что вы написали подробную инструкцию для этого секретаря — один раз, тщательно — и положили её в папку на столе. Каждый раз, когда вам нужна проверка письма, вы просто говорите «вот письмо, работай по инструкции номер три». Секретарь открывает нужный лист, читает, делает всё правильно.

Skill — это такая инструкция, написанная один раз и сохранённая так, чтобы Claude получал её автоматически при каждом нужном запросе. Вы не повторяете задание вслух — оно уже внутри команды.

Технически skill — это папка внутри .claude/skills/, а в ней обязательный файл SKILL.md. Имя папки становится именем команды: папка otchet/ вызывается как /otchet. Когда вы набираете /имя, Claude читает SKILL.md как часть вашего запроса — точно так же, как если бы вы вставили его содержимое вручную.

Плоские файлы тоже работают, но в другой папке: .claude/commands/otchet.md даёт ту же команду /otchet. Это один и тот же механизм — команды и скиллы объединены. Папка со SKILL.md умеет больше: рядом можно положить шаблоны и примеры, а во frontmatter — задать, кто может вызывать скилл.

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

Как работает на практике

Разберём на реальном примере — создадим skill для проверки деловых писем.

Шаг 1. Найдите или создайте папку .claude/skills/

В вашем основном рабочем каталоге — том, откуда вы запускаете Claude — создайте структуру:

мой-рабочий-каталог/
└── .claude/
    └── skills/
        └── revyu-pisma/
            └── SKILL.md

Если папка .claude уже есть (она появилась в Дне 11, когда вы создавали CLAUDE.md), просто добавьте внутри неё подпапку skills.

Шаг 2. Напишите skill-файл

Откройте revyu-pisma/SKILL.md и напишите инструкцию — так, как если бы объясняли задачу очень внимательному человеку в первый раз:

# Ревью делового письма

Проверь приложенный текст письма по следующим критериям:

**Тон и формальность**
- Письмо должно быть формальным, но живым — без канцелярита типа «в целях осуществления»
- Обращение соответствует статусу получателя
- Нет агрессии, извинений там, где они не нужны, или чрезмерной мягкости

**Структура**
- Есть ли чёткий запрос или следующий шаг в конце
- Вступление не затянуто — сразу к сути
- Абзацы не длиннее 4-5 строк

**Риски**
- Есть ли фразы, которые можно трактовать двусмысленно
- Нет ли обещаний, которые трудно выполнить
- Даты и цифры — конкретны или размыты

**Формат ответа**
Сначала общая оценка (1-2 предложения). Потом конкретные правки: цитата из письма → что изменить и почему. Не больше 5 правок — только существенные.

Шаг 3. Используйте команду

Теперь в любом разговоре с Claude введите:

/revyu-pisma

[вставьте текст письма]

Claude прочитает ваш skill-файл как часть задачи и выполнит проверку именно по вашим критериям — без лишних пояснений с вашей стороны.

Шаг 4. Уточняйте и улучшайте

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

Типичная траектория: первый запуск даёт правильное содержание, но неудобный формат. Добавляете в skill секцию «Формат ответа» — и со второго раза структура уже такая, как нужно. Третий-четвёртый запуск — понимаете, что упустили какой-то важный критерий. Дописываете. К пятому запуску skill работает именно так, как вы хотели с самого начала. Это нормальный путь, не признак того, что что-то пошло не так.

Вот ещё два примера skill-файлов для типичных задач директора:

analiz-dogovora.md:

# Анализ договора: риски нашей стороны

Проанализируй приложенный договор с позиции защиты интересов нашей стороны (покупателя услуг / заказчика).

Найди и структурируй по разделам:

1. **Финансовые риски** — штрафы, пени, автоматическое продление, скрытые платежи
2. **Операционные риски** — сроки, которые трудно выполнить; обязательства без чёткого критерия выполнения
3. **Правовые риски** — односторонние права другой стороны, размытые формулировки, отсутствие ответственности контрагента
4. **Что отсутствует** — типовые защитные пункты, которых нет в этом договоре

Для каждого риска: цитата из договора → что именно опасно → как можно переформулировать.
Заверши кратким выводом: подписывать как есть, подписывать с правками, или требует юридической экспертизы.

nedelniy-otchet.md:

# Недельный отчёт для руководства

Преврати приложенные данные в недельный отчёт для руководства.

Структура:
1. **Итог недели** — 2-3 предложения: что сделано, главный результат, главная проблема
2. **Выполнено** — конкретные пункты с результатами (цифры, если есть)
3. **В работе** — что продолжается, с ожидаемыми сроками
4. **Риски и блокеры** — что может сорвать план
5. **Следующая неделя** — 3 приоритета

Тон — деловой, без воды. Руководство читает быстро — каждый пункт должен быть понятен за 5 секунд.

Частые ошибки

Ошибка 1. Слишком общая инструкция

«Проверь это письмо» — не skill, это просто запрос. Skill должен кодировать ваши конкретные критерии: что значит «хорошее письмо» в вашем понимании, какой формат ответа вы хотите, на что обращать внимание в первую очередь.

Если после вызова skill вы думаете «ну, в общем-то правильно, но не совсем то» — значит, инструкция слишком абстрактна. Откройте файл и добавьте конкретики.

Ошибка 2. Один skill на всё

Соблазн велик: написать один большой skill «анализ документов» и запихать туда всё. В результате получается длинный запутанный файл, который плохо работает для каждой конкретной задачи.

Лучше иметь три узких skill — analiz-dogovora.md, analiz-kp.md, analiz-otcheta.md — каждый заточен под свою задачу. Вызывать нужный проще, чем объяснять большому, что именно сейчас нужно.

Ошибка 3. Забыть обновить skill после изменения процесса

У вас поменялся формат отчётов для руководства — новый руководитель предпочитает другую структуру. Старый skill продолжает генерировать по-старому, вы каждый раз поправляете вручную и не понимаете, почему Claude «не слушается».

Простое правило: поменялся реальный процесс — обновите skill. Это занимает две минуты.

Ошибка 4. Путать skill с агентом

Skill — это инструкция, но она умеет больше, чем просто текст: строка вида !`команда` подставит в промт живой вывод команды, поле allowed-tools заранее разрешает инструменты, а context: fork выполняет скилл в отдельном субагенте. Если вам нужно, чтобы Claude сам нашёл нужные файлы, прочитал несколько документов и собрал итог — это задача для агента (День 22), а не для skill.

Когда нужно / когда нет

Skills нужны, когда:

• Одну и ту же инструкцию вы даёте Claude чаще двух раз в неделю
• Результат должен быть предсказуемым по структуре — одинаковый формат из раза в раз
• Задача хорошо определена: конкретный вход, конкретный выход, понятные критерии
• Вы хотите, чтобы коллеги использовали тот же процесс — можно передать папку .claude/skills/ вместе с проектом

Skills не нужны, когда:

• Задача каждый раз разная по сути, только похожая по теме — здесь лучше написать хороший CLAUDE.md с контекстом
• Нужна не инструкция, а роль с инструментами — это агент
• Задача разовая — просто напишите запрос, не тратьте время на создание файла
• Процесс ещё не устоялся — сначала поработайте с прямыми запросами, найдите правильную формулировку, потом зафиксируйте как skill

Ещё одна ситуация, когда skills особенно полезны: делегирование. Если вы хотите, чтобы другой человек (ассистент, коллега) мог использовать Claude для тех же задач с теми же критериями — skill даёт это «из коробки». Не нужно объяснять словами, как именно вы хотите видеть анализ договора — передайте файл, и процесс воспроизводится точно.

Важный нюанс про называние команд: /ревью-письма и /revyu-pisma — разные команды, потому что это разные имена папок. Если у вас несколько skills на похожие темы, дайте им имена, которые вы точно не перепутаете через неделю. Хорошие имена: analiz-dogovora, revyu-pisma, nedelniy-otchet. Плохие имена: doc1, task, proverka — через месяц не вспомните, что именно проверяется.

Связь с другими уроками

День 11 — CLAUDE.md — глобальный контекст о вас, вашей компании, предпочтениях. Skill и CLAUDE.md работают вместе: CLAUDE.md объясняет, кто вы и какой контекст важен, skill объясняет, как именно выполнить конкретную задачу. Если в skill нет отраслевой специфики — она приходит из CLAUDE.md автоматически.

День 22 — первый агент — разница между skill и агентом принципиальна. Агент живёт в .claude/agents/, имеет инструменты и может работать самостоятельно. Skill живёт в .claude/skills/, это инструкция: вызвать её можете вы командой, а по умолчанию Claude может применить её и сам. Понимание этой разницы помогает выбрать правильный инструмент под задачу.

День 32 — slash-команды — следующий урок расширит эту тему: вы узнаете, как slash-команды параметризуются, как передавать в них данные, и как строить более сложные skill-сценарии, которые работают с вводом разного типа.

Задание на сегодня

Создайте один skill для задачи, которую вы выполняете с Claude хотя бы раз в неделю.

Выберите что-то конкретное — проверку писем, анализ документов, подготовку отчётов. Не пытайтесь охватить всё сразу.

1. Создайте папку .claude/skills/ в вашем рабочем каталоге (если её нет)
2. Создайте папку с именем в латинице, например revyu-pisma/, и внутри неё файл SKILL.md
3. Запишите инструкцию: что проверять, в каком формате отвечать, на что обращать внимание
4. Вызовите skill командой /имя-папки с реальным текстом

Критерий «выполнено»: вы вызвали skill и получили результат, который не нужно переформулировать, чтобы использовать — он уже в нужном формате и по нужным критериям.

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

Резюме

• Skill — папка в .claude/skills/ с файлом SKILL.md, вызывается командой /имя-папки. Содержит инструкцию для повторяющейся задачи.
• Skill фиксирует ваши критерии один раз, чтобы не объяснять их каждый раз заново. Это предсказуемость и экономия времени.
• Разница от агента: skill — инструкция-шаблон, агент — роль с инструментами. Skill вызываете вы — или Claude сам, если не выставлен disable-model-invocation: true; агент работает самостоятельно.
• Хорошие кандидаты в skills: проверка писем, анализ договоров, структурирование отчётов — всё, что вы делаете регулярно по одной схеме.
• Skill работает в паре с CLAUDE.md: глобальный контекст из CLAUDE.md + конкретная инструкция из skill = стабильный результат без повторных объяснений каждый раз.
• Начните с одного skill для самой частой задачи — потом расширите библиотеку по мере необходимости.