лооооч
Урок 4

Регламент

Эпизод 4 дела 2024-307: Артём пишет инструкцию один раз — и больше к ней не возвращается

Цели урока

К концу этого урока вы:

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

Замри на секунду. Сейчас будет интересно.

Артём смотрит в монитор. На экране — окно с консультантом, открытое в третий раз за сегодняшний вечер. Третий раз — тот же запрос, то же объяснение: как устроена процедура разбора входящего платёжного поручения. Что искать сначала. Какие поля проверять. Когда ставить флаг «подозрительно».

Майя стоит у двери с термосом. Она смотрела на это, не перебивая, минуты три. Потом:

«Гречко.»

Артём обернулся.

«Ты в третий раз объясняешь одно и то же. Это не работа — это диктовка. Выпиши инструкцию. Один раз. Положи в папку. Всё.»

Она ушла. Артём уставился в экран. Выпиши инструкцию. Он знал, как это называется: Skill. Он знал, что эта возможность есть. Просто до сих пор казалось, что написать Skill — это для чего-то важного. А не для разбора платёжек по делу 2024-307.

Урок 4 из 8

Регламент

Эпизод 4 дела 2024-307: Артём пишет инструкцию один раз — и больше к ней не возвращается
Потёртый процедурный блокнот на столе — левая страница в плотных рукописных пометках, правая чистая, перьевая ручка на корешке
Урок 1 — Холодное досье Майя получила дело 2024-307 и ультиматум Захарова. Первый сеанс с консультантом — четыре барьера сняты.
Урок 2 — Первый допрос Анатомия запроса из четырёх элементов. Project как картотека по делу. Разбор PDF и Excel в Desktop.
Урок 3 — Связка отмычек Майя выписала консультанту допуск. MCP и Connectors: что можно дать, что нельзя. Реестр доступов.
Урок 4 — сегодня Skill = регламент в папке отдела. Пишем первую инструкцию, тестируем, итерируем.

Что вы возьмёте из этого урока

  • Поймёте, чем 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.

🤔 Прикиньте до того, как читать дальше
В Уроке 3 Майя выписала консультанту допуск в реестр юрлиц через MCP. Теперь Артём хочет написать Skill для разбора платёжек. Предположите: что именно должно быть в этом Skill, чего нет в самом платёжном поручении? Какой шаг Артём повторяет каждый раз — и именно его надо упаковать?
Документ содержит данные. Skill содержит алгоритм: какие поля проверять, в каком порядке, что считать признаком подозрительности, какой формат у финального вывода. Именно этот алгоритм Артём каждый раз диктовал заново — и именно его надо записать один раз.

Часть 2. Анатомия Skill: как он устроен

Skill — это папка с файлом SKILL.md внутри. Минимально жизнеспособный Skill состоит из одного файла. Всё остальное — по желанию и по задаче. [1]

~/.claude/skills/razбор-platezhki/ ├── SKILL.md ← главный файл с инструкцией для консультанта ├── templates/ │ └── report-template.md ← шаблон итогового отчёта └── examples/ └── good-output-example.md ← пример правильного разбора

Структура 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]

Майя взяла со стола Артёма его блокнот. Нашла страницу с пометкой «алгоритм платёжки». Там было записано семь шагов — аккуратно, со стрелками. Написано три месяца назад, когда он только пришёл в отдел.

«У тебя уже есть регламент. Ты его не потерял. Ты просто не положил его туда, где консультант мог бы его прочитать.»

Под капотом: консультант при старте сессии загружает только первые ~30—50 слов каждого установленного Skill — ровно 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 с description: «Use when user wants something financial.»
*Консультант решил, что это подходит для любого вопроса о деньгах*
*Skill активировался, когда Артём попросил найти кафе с чаевыми*
*Skill не активировался, когда Артём написал «разбери платёжку»*
description — это словарь совпадения, не пожелание. Если в нём нет «разбери платёжку» — не ждите, что Skill сработает на эти слова.

Часть 4. Тестирование Skill'а

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

Новый чат Skill активируется Результат проверяете каждый шаг OK Skill готов работает стабильно не так Правьте SKILL.md, не промпт добавьте шаг / уточните формат / добавьте НИКОГДА
Цикл итерации Skill: прогон — результат — правка SKILL.md — снова. Правьте файл, а не промпт в чате.
Спиральный блокнот открыт на столе — левая страница в плотных рукописных исправлениях со стрелками, правая чистая, лампа освещает только блокнот
Правьте SKILL.md, не промпт в чате. Итерация — это работа, а не ошибка.

Артём записал себе: «Тест — новый чат, запрос — проверить каждый шаг чек-листа в выводе.» Если пункт из SKILL.md пропущен в выводе — это не случайность, это пробел в инструкции. Артём открывает SKILL.md, добавляет или уточняет шаг, сохраняет, запускает снова.

Практика: нормально тратить 1–2 часа на хороший Skill в первый раз. Это окупается за 5–10 запусков. Артём за три вечера объяснял одно и то же — это 15–20 потерянных минут. За месяц с делом 2024-307 — несколько часов. Skill написался за полтора часа. Окупается к концу первой недели расследования.

✋ Самотест — не подсматривайте
Закройте описание Skill'а из Части 3. Что должно быть в поле description, чтобы консультант активировал Skill при запросе «дай саммари писем за неделю»?
Ответ: конкретные фразы-триггеры: «weekly summary», «саммари за неделю», «дайджест», «разбор недели». Абстрактное «суммирует письма» — не работает. description — словарь совпадения, а не описание для человека.

Часть 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?
А) Еженедельный дайджест писем от контрагентов. Б) Анализ договора, который прислали сегодня утром первый и последний раз. В) Сверка входящих платёжек с реестром — каждый день по 10–15 штук. Г) Написание поздравительного письма директору на юбилей.
Skill стоит писать для А и В. Б и Г — разовые, там проще написать хороший промпт. Ключевая метрика: сколько раз вы произнесёте одну и ту же инструкцию за месяц? Если больше восьми — Skill окупится.

Резюме

1

Skill — инструкция по действию, Project — контекст по теме

Не конкуренты. Project отвечает «над чем работаем», Skill — «как именно». Skill «разбор платёжки» живёт внутри Project «2024-307».

2

Skill = папка с SKILL.md

Обязательно: name и description в фронтматтере. Опционально: примеры, шаблоны. description — словарь совпадения, по нему консультант решает, применять ли Skill.

3

ВСЕГДА / НИКОГДА — условия приёмки

ВСЕГДА — обязательные элементы вывода. НИКОГДА — запреты без исключений. Без этих разделов инструкция протекает на деталях, которые вам кажутся очевидными.

4

Итерация — нормально

3–5 прогонов с правками SKILL.md до хорошего результата. Правьте файл, а не промпт в чате. В деле 2024-307 Артём сделал это один раз — и больше не объяснял алгоритм заново.

5

Узкий Skill лучше широкого

Пять одноцелевых Skill'ов работают надёжнее, чем один «обо всём». Узкий description — точный триггер. Широкий description — шум.

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

Написать инструкцию один раз — это и есть работа следователя. Остальное — уже не работа, а механика.

Источники / Sources

  1. docs Anthropic. «Extend Claude with skills» — полная документация по Skills: структура папки, поля SKILL.md, description, where skills live, lifecycle. code.claude.com/docs/en/skills · accessed 2026-05-16
  2. docs Anthropic. «Claude Code overview» — что такое Claude Code, как работает, возможности для нетеха. code.claude.com/docs/en/overview · accessed 2026-05-16
  3. docs Anthropic (2024). «Introduction to the Model Context Protocol» — открытый протокол подключения моделей к внешним данным; Skills и MCP работают вместе. modelcontextprotocol.io/introduction · accessed 2026-05-16
  4. docs Anthropic. «Models overview» — контекстное окно моделей; Skill-тело загружается только при активации, не занимая контекст постоянно. docs.anthropic.com/en/docs/about-claude/models · accessed 2026-05-16
Сюжет дела «2024-307», отдел «Тёмные офисы» и его сотрудники — художественная рамка курса. Технические факты о Skills, MCP и структуре SKILL.md опираются на источники выше. Сцены с Артёмом и Майей — вымысел; поведение консультанта — реально.