Регламент
Эпизод 4 дела 2024-307: Артём пишет инструкцию один раз — и больше к ней не возвращается
Цели урока
К концу этого урока вы:
- Поймёте, чем Skill отличается от Project — и почему они не конкуренты, а соседи.
- Разберёте анатомию Skill: структуру папки, поля в SKILL.md, почему description — главное поле.
- Напишете первый собственный Skill пошагово и протестируете его в новом чате.
- Поймёте разделы ВСЕГДА / НИКОГДА в Skill'е и почему без них инструкция протекает.
- Узнаете, когда Skill окупается, а когда — просто лишняя работа.

Замри на секунду. Сейчас будет интересно.
Артём смотрит в монитор. На экране — окно с консультантом, открытое в третий раз за сегодняшний вечер. Третий раз — тот же запрос, то же объяснение: как устроена процедура разбора входящего платёжного поручения. Что искать сначала. Какие поля проверять. Когда ставить флаг «подозрительно».
Майя стоит у двери с термосом. Она смотрела на это, не перебивая, минуты три. Потом:
«Гречко.»
Артём обернулся.
«Ты в третий раз объясняешь одно и то же. Это не работа — это диктовка. Выпиши инструкцию. Один раз. Положи в папку. Всё.»
Она ушла. Артём уставился в экран. Выпиши инструкцию. Он знал, как это называется: Skill. Он знал, что эта возможность есть. Просто до сих пор казалось, что написать Skill — это для чего-то важного. А не для разбора платёжек по делу 2024-307.
Регламент
Что вы возьмёте из этого урока
- Поймёте, чем Skill отличается от Project — и почему они не конкуренты, а соседи.
- Разберёте анатомию Skill: структуру папки, поля в
SKILL.md, почемуdescription— главное поле. - Напишете первый собственный Skill пошагово и протестируете его в новом чате.
- Поймёте разделы ВСЕГДА / НИКОГДА в Skill'е и почему без них инструкция протекает.
- Узнаете, когда Skill окупается, а когда — просто лишняя работа.
Часть 1. Откуда берётся проблема
В Уроке 2 мы разобрали Project — картотеку по теме на столе Артёма. Там лежат документы: реестры, прошлые разборы, контекст по делу. Консультант читает всё это и помнит, пока Project открыт. Хорошая вещь. Но у неё есть слепое пятно: Project не знает, как именно нужно работать.
Представьте: у вас в Project «2024-307» лежит сотня платёжных поручений. Когда каждый раз просишь консультанта разобрать новое — снова объясняешь: «смотри на реквизиты плательщика, отдельно проверь назначение платежа, сравни с реестром известных юрлиц, флаг «подозрительно» ставь если…». Project хранит файлы. Но алгоритм разбора — у тебя в голове, и каждый раз надо его диктовать.
Именно это делал Артём три вечера подряд. И именно от этого его остановила Майя.
Project
«2024-307». Файлы, контекст по делу. Отвечает на вопрос: над чем работаем?
Skill
«Разбор платёжного поручения». Инструкция по действию, применима к любому документу. Отвечает на вопрос: как именно работаем?
Ключевая мысль: Project отвечает «над ЧЕМ работаем», Skill — «КАК работаем». Они комплементарны — не конкуренты. Skill «разбор платёжки» отлично работает внутри Project «2024-307»: файлы берёт из Project, алгоритм — из Skill.
Часть 2. Анатомия Skill: как он устроен
Skill — это папка с файлом SKILL.md внутри. Минимально жизнеспособный Skill состоит из одного файла. Всё остальное — по желанию и по задаче. [1]
Структура SKILL.md
Файл начинается с так называемого «фронтматтера» — метаданных в формате YAML (текст между тройными дефисами). Там два ключевых поля: name и description. После метаданных — тело инструкции в обычном Markdown. [1]
---
name: razбор-platezhki
description: Use when user asks to analyze payment order,
разобрать платёжное поручение, проверить платёжку,
флагануть платёж, payment analysis.
---
# Инструкция: разбор платёжного поручения
## Шаги выполнения
1. Определи плательщика: ИНН, наименование, банк
2. Определи получателя: ИНН, наименование, банк
3. Зафиксируй: сумму, дату, назначение платежа
4. Сверь ИНН плательщика с реестром известных юрлиц
5. Проверь назначение платежа на признаки «виртуальной услуги»
6. Вынеси вердикт: ЧИСТО / ПОДОЗРИТЕЛЬНО / ТРЕБУЕТ ПРОВЕРКИ
## ВСЕГДА
- ВСЕГДА указывай имя файла-источника для каждого факта
- ВСЕГДА завершай разбор кратким выводом в одном абзаце
## НИКОГДА
- НИКОГДА не ставь флаг ЧИСТО без проверки ИНН по реестру
- НИКОГДА не выдумывай реквизиты, которых нет в документе
Главное поле — description. Консультант читает его при каждом запросе и решает, применять ли этот Skill. Если description нечёткий — Skill не сработает в нужный момент. Правило: description пишите в форме «Use when user asks…» и добавляйте конкретные фразы-триггеры — те слова, которые реально произносите. На русском и на английском. [1]
Майя взяла со стола Артёма его блокнот. Нашла страницу с пометкой «алгоритм платёжки». Там было записано семь шагов — аккуратно, со стрелками. Написано три месяца назад, когда он только пришёл в отдел.
«У тебя уже есть регламент. Ты его не потерял. Ты просто не положил его туда, где консультант мог бы его прочитать.»
name и description. Тело инструкции загружается только тогда, когда консультант решил, что этот Skill подходит. Это значит: можно держать 20—30 Skill'ов и не бояться, что контекстное окно перегружено — большинство из них «спят» до востребования. [1]
Часть 3. Создаём первый Skill — пошагово
Артём открыл терминал. Майя ушла в кабинет — ей не нужно смотреть на процесс, ей нужен результат. Артём прошёл пять шагов, которые вы сейчас разберёте вместе с ним.
Шаг 1. Создайте папку для Skill
В Claude Code личные Skill'ы (доступные во всех проектах) хранятся в ~/.claude/skills/. Создайте подпапку с именем вашего Skill'а: например, ~/.claude/skills/weekly-email-digest/. Имя — короткое, через дефис, только латиница и цифры.
Шаг 2. Создайте файл SKILL.md
Внутри папки создайте файл с именем SKILL.md (именно в верхнем регистре — это обязательное имя). Откройте его в любом текстовом редакторе: Notepad, TextEdit, VS Code.
Шаг 3. Напишите description — строго по формуле
Формула: «Use when user asks for [что-то], [русская фраза], [ещё вариант]». Для примера weekly-email-digest:
Use when user asks for weekly email summary, дайджест писем, разбор недели в почте, что пришло за неделю, итоги почты.
Шаг 4. Напишите тело — чек-лист из 5–7 шагов, плюс ВСЕГДА / НИКОГДА
Конкретно. Пример готового SKILL.md для weekly-email-digest:
---
name: weekly-email-digest
description: Use when user asks for weekly email summary,
дайджест писем, разбор недели в почте, что пришло за неделю.
---
# Недельный дайджест писем
1. Через MCP-Gmail возьми все письма за последние 7 дней
2. Сгруппируй по отправителям (домен или имя)
3. По каждому отправителю — 1-2 предложения: о чём писали
4. В конце — список 3 самых важных писем с темой и кратким содержанием
ВСЕГДА: проверь, что охватил ровно 7 дней
ВСЕГДА: формат — Markdown с заголовками
НИКОГДА: не выдумывай отправителей и темы писем
Шаг 5. Сохраните. Добавьте шаблоны при необходимости
Сохраните файл. Skill появится в системе. Если хотите дать консультанту шаблон для вывода — создайте подпапку templates/ и положите туда файл. Сошлитесь на него в теле SKILL.md.
*Консультант решил, что это подходит для любого вопроса о деньгах*
*Skill активировался, когда Артём попросил найти кафе с чаевыми*
*Skill не активировался, когда Артём написал «разбери платёжку»*
description — это словарь совпадения, не пожелание. Если в нём нет «разбери платёжку» — не ждите, что Skill сработает на эти слова.
Часть 4. Тестирование Skill'а
Skill написан. Теперь — проверка. Важный нюанс: тестировать Skill надо в новом чате, не в том, где вы его редактировали. Только так консультант загрузит его так, как загрузит в реальной работе.
Артём записал себе: «Тест — новый чат, запрос — проверить каждый шаг чек-листа в выводе.» Если пункт из SKILL.md пропущен в выводе — это не случайность, это пробел в инструкции. Артём открывает SKILL.md, добавляет или уточняет шаг, сохраняет, запускает снова.
Практика: нормально тратить 1–2 часа на хороший Skill в первый раз. Это окупается за 5–10 запусков. Артём за три вечера объяснял одно и то же — это 15–20 потерянных минут. За месяц с делом 2024-307 — несколько часов. Skill написался за полтора часа. Окупается к концу первой недели расследования.
description, чтобы консультант активировал Skill при запросе «дай саммари писем за неделю»?Часть 5. ВСЕГДА и НИКОГДА — как сделать инструкцию непротекаемой
Майя зашла за час до полуночи. Артём показал первый результат работы Skill'а на тестовой платёжке. Она прочитала, отложила лист.
«Хорошо. Но где источник? Ты написал «ИНН 7724567890 числится в реестре». В каком файле ты это нашёл?»
Артём открыл SKILL.md. Добавил строку: ВСЕГДА указывай имя файла-источника для каждого факта. Запустил снова. Майя прочитала новый результат, кивнула и ушла.
Разделы ВСЕГДА и НИКОГДА в Skill — это не рекомендации. Это условия приёмки результата. Без них даже хорошая инструкция «протекает»: консультант следует духу, но пропускает детали, которые вам кажутся очевидными.
ВСЕГДА — обязательные элементы любого вывода
То, что должно быть в каждом ответе без исключений. Примеры: «ВСЕГДА указывай имя файла-источника», «ВСЕГДА проверяй, что охватил ровно 7 дней», «ВСЕГДА завершай кратким выводом в одном абзаце».
НИКОГДА — запреты без права на исключение
То, что делать нельзя ни при каких обстоятельствах. Примеры: «НИКОГДА не выдумывай реквизиты», «НИКОГДА не ставь флаг ЧИСТО без проверки по реестру», «НИКОГДА не отправляй письма без явного запроса».
Что НЕ делать: не создавайте Skill «универсальный помощник по работе». Это превратится в свалку. Skill должен быть узким и одноцелевым. Лучше пять узких Skill'ов, чем один «обо всём» — потому что у «одного обо всём» description невозможно написать так, чтобы консультант его адекватно активировал. В деле 2024-307 у Артёма отдельный Skill для разбора платёжек, отдельный для реестра юрлиц, отдельный для итогового протокола.
Часть 6. Когда Skill окупается — а когда нет
Skill — инвестиция. Написать хороший Skill с первого раза занимает 1–2 часа. Как и любая инвестиция, он имеет смысл только если окупится.
Skill окупается, если задача:
Повторяющаяся
Хотя бы раз в неделю — идеально. Раз в две недели — приемлемо. Для Артёма разбор входящих платёжек по делу — ежедневный процесс.
Алгоритмическая
Есть чёткий порядок шагов: «сделай 1, потом 2, потом 3». Семь шагов в блокноте Артёма — готовый алгоритм, ждавший оцифровки.
Требует длинного промпта
Больше 10 строк инструкции каждый раз. Если у вас 2 строки — проще писать промпт руками.
Skill НЕ окупается, если задача:
Разовая или редкая
Анализ конкретного отчёта без плана повторить. Написание одного конкретного письма. Лучше потратить 5 минут на промпт, чем 2 часа на Skill.
Формулировка каждый раз сильно меняется
Если «разбор» каждую неделю выглядит по-другому — алгоритм не выкристаллизуется. Сначала найдите повторяющийся шаблон, потом пишите Skill.
Резюме
Skill — инструкция по действию, Project — контекст по теме
Не конкуренты. Project отвечает «над чем работаем», Skill — «как именно». Skill «разбор платёжки» живёт внутри Project «2024-307».
Skill = папка с SKILL.md
Обязательно: name и description в фронтматтере. Опционально: примеры, шаблоны. description — словарь совпадения, по нему консультант решает, применять ли Skill.
ВСЕГДА / НИКОГДА — условия приёмки
ВСЕГДА — обязательные элементы вывода. НИКОГДА — запреты без исключений. Без этих разделов инструкция протекает на деталях, которые вам кажутся очевидными.
Итерация — нормально
3–5 прогонов с правками SKILL.md до хорошего результата. Правьте файл, а не промпт в чате. В деле 2024-307 Артём сделал это один раз — и больше не объяснял алгоритм заново.
Узкий Skill лучше широкого
Пять одноцелевых Skill'ов работают надёжнее, чем один «обо всём». Узкий description — точный триггер. Широкий description — шум.
Что дальше, в Уроке 5 — «Выезд на адрес»: в подвальном архиве лежат данные, которые консультант через облако не достаёт. Артём берёт ноутбук и едет «на место» — знакомство с Claude Code, терминал без страха для нетеха, первый локальный запуск. Skill'ы из этого урока вы возьмёте с собой — они работают и в Code.
Источники / Sources
- docs Anthropic. «Extend Claude with skills» — полная документация по Skills: структура папки, поля SKILL.md, description, where skills live, lifecycle.
- docs Anthropic. «Claude Code overview» — что такое Claude Code, как работает, возможности для нетеха.
- docs Anthropic (2024). «Introduction to the Model Context Protocol» — открытый протокол подключения моделей к внешним данным; Skills и MCP работают вместе.
- docs Anthropic. «Models overview» — контекстное окно моделей; Skill-тело загружается только при активации, не занимая контекст постоянно.