Веду эти разборы публично. В канале регулярно показываю инструменты, рабочие промпты и провалы вайб-кодинга, на которые сам налетел. Подпишись там, где удобнее:
Что такое Skill в Claude Code и почему это не «промпт побольше»?
Claude Code Skills - родная фича Claude Code, которую Anthropic запустил в октябре 2025 для Pro/Max/Team/Enterprise. Позже они открыли спецификацию Agent Skills как стандарт, который работает не только в Claude. В коде это просто папка:
.claude/skills/
├── deploy-to-prod/
│ ├── SKILL.md
│ └── scripts/
│ └── check-migrations.sh
├── weekly-content-plan/
│ └── SKILL.md
└── triage-support-tickets/
└── SKILL.mdКаждая папка - это один навык. Файл SKILL.md - markdown с YAML-frontmatter сверху и обычной инструкцией ниже. Когда юзер просит «давай задеплоим в прод», Claude видит description навыка deploy-to-prod, узнаёт триггер «деплой в прод», подгружает тело SKILL.md в контекст и идёт по шагам.
Три уровня прогрессивной загрузки
Anthropic построил skills с прогрессивной загрузкой - данные подгружаются слоями, по мере необходимости. В блоге Anthropic Engineering команда формулирует это как «core design principle that makes Agent Skills flexible and scalable» (Barry Zhang, Keith Lazuka, Mahesh Murag).
Три уровня загрузки:
- Metadata (всегда) - при запуске сессии Claude видит только
nameиdescriptionкаждого skill. Бюджет: примерно 100 токенов на skill. - Instructions (по триггеру) - когда юзер сказал что-то релевантное, Claude грузит тело SKILL.md. Бюджет: меньше 5000 токенов.
- Resources (по запросу) - бандлированные файлы (примеры, шаблоны, дата-сеты) подтягиваются только когда модель сама лезет за ними. Бюджет: безлимитный.
Раньше в CLAUDE.md приходилось пихать всё, что ИИ должен «помнить» - и проект на 50 правил быстро упирался в потолок контекста. С skills в одном проекте легко уживаются десятки навыков, потому что в стартовый контекст попадают только их description'ы.
Где живут skills - четыре уровня
| Уровень | Путь | Применяется к |
|---|---|---|
| Enterprise | Managed settings организации | Все юзеры компании |
| Personal | ~/.claude/skills/<имя>/SKILL.md | Все твои проекты |
| Project | .claude/skills/<имя>/SKILL.md | Только этот проект |
| Plugin | <plugin>/skills/<имя>/SKILL.md | Где плагин включён |
Приоритет: enterprise перекрывает personal, personal перекрывает project. Плагины используют namespace plugin-name:skill-name и не конфликтуют. Это удобно: общие профессиональные навыки кладёшь в ~/.claude/skills/, проектные специфичные - в .claude/skills/ репозитория.
Как устроен SKILL.md изнутри?
Минимальный пример - двадцать строк, и навык готов:
---
name: weekly-content-plan
description: Готовит план постов на неделю для Telegram-канала и Reels. Триггеры - "сделай план постов", "что постить на этой неделе", "план в канал на 7 дней". Не активируйся, если речь про сайт или email-рассылку.
---
# Weekly Content Plan
## Шаги
1. Прочитай `knowledge/audience.md` - кому пишем
2. Прочитай `knowledge/tone-of-voice.md` - как пишем
3. Прочитай последние 10 постов в канале - что уже было
4. Сформируй 7 тем на неделю: 3 продающие, 2 экспертные, 2 личные
5. Под каждую - одна строка-зацеп и три буллета о чём пост
6. Выведи в формате таблицы: день недели | тип | зацеп | планЭтого достаточно. Если юзер пишет «давай план постов на неделю», Claude видит триггер в description, грузит SKILL.md, читает названные файлы, выдаёт таблицу.
Лимиты, которые надо помнить
В официальной документации Claude API лимиты заданы жёстко:
name: до 64 символов, только lowercase + цифры + дефис, без XML-тегов. Зарезервированыanthropicиclaude.description: до 1024 символов в API, обязательное поле, без XML-тегов.- Listing budget: в Claude Code описания всех skills вместе занимают около 1% контекстного окна. Если skills много, описания будут обрезаны - и ключевые слова, по которым Claude должен матчить, пропадут.
- SKILL.md body: Anthropic рекомендует держать тело в пределах 500 строк. Всё, что больше - выносить в файлы
references/,scripts/,examples/и подтягивать через инструкции.
После авто-сжатия контекста (/compact) Claude удерживает первые 5000 токенов каждого ранее вызванного skill, общий бюджет на все re-attached skills - 25 000 токенов. Если навык не помещается - его поведение «забывается».
Полная схема frontmatter
Минимум - name и description. Но в production-skills используются и другие поля:
| Поле | Назначение | Пример |
|---|---|---|
name | Имя skill, если опущено - имя папки | deploy-to-prod |
description | Триггер для авто-инвокации | См. формулу ниже |
when_to_use | Дополнительные триггер-фразы | ["задеплой", "выкатим"] |
allowed-tools | Какие tools можно без запроса permission | ["Read", "Bash(npm run build)"] |
disable-model-invocation | true - только юзер может вызвать | Для опасных операций |
user-invocable | false - только Claude может вызвать | Для фоновых знаний |
paths | Glob-паттерны, где skill активен | ["src/**/*.ts"] |
context: fork | Запуск в изолированном subagent | Когда тяжёлый контекст |
agent | Тип subagent для запуска | Explore, Plan, general-purpose |
effort | Уровень reasoning | low, medium, high, xhigh, max |
model | Какой модели передать skill | claude-opus-4-7 |
hooks | Хуки на lifecycle skill | См. раздел про hooks |
Поле disable-model-invocation: true - это must-have для всего, что не должно срабатывать автоматически. Например, навык deploy-to-prod с этим флагом будет вызываться только если юзер явно написал /deploy-to-prod. Без флага Claude может задеплоить, потому что «код выглядит готовым».
Почему description решает 90% работы и как его написать?
Самая частая ошибка вайб-кодера - написать description в стиле «Helper for X». Skill при этом физически существует, лежит в папке, но Claude его не вызывает.
Плохой description
description: Build dashboards.Что Claude не понимает: когда юзер просит «покажи мне продажи за неделю» - это про dashboard или нет? Когда юзер просит «график по выручке» - это про dashboard или про график вообще? Когда «отчёт за месяц» - точно не dashboard?
Anthropic в своём skill-creator формулирует рекомендацию прямо:
Currently Claude has a tendency to "undertrigger" skills - to not use them when they'd be useful. To combat this, please make the skill descriptions a little bit "pushy".
Формула хорошего description
Три части:
- Что делает - одно предложение про результат, не про процесс. Не «генерирует SQL», а «выгружает продажи в табличку для Telegram-канала».
- Когда триггерить - 3-5 фраз в кавычках, как реально просят юзеры. Не угадывай, посмотри в свою историю чатов и саппорта.
- Когда НЕ триггерить - 1-2 фразы про похожие задачи, на которые этот навык не должен реагировать. Без этого блока двух близких skills постоянно конфликтуют.
Пример сильного description из моего проекта (упрощено и обезличено):
description: |
Пишет и публикует SEO-гайд в блог по канону редполитики.
Триггеры: "напиши гайд про X", "давай новый pillar",
"статья в блог про Y", "build blog guide про Z".
Не активируйся, если речь про email-рассылку,
пост в Telegram или внутреннюю инструкцию команды -
это другие навыки.Что здесь работает:
- Глагол «пишет и публикует» вместо «помогает с» - конкретный результат.
- 4 триггер-фразы в кавычках - покрывают разные формулировки.
- Английский триггер тоже включён - если юзер переключился на язык команды, навык всё равно сработает.
- Отдельный блок «не активируйся, если» - закрывает конфликт с email-навыком и пост-навыком.
Как протестировать description
Anthropic в своём skill-creator зашил методику trigger-evals: 20 промптов, по которым проверяется, активируется ли навык. 10 должны его триггерить, 10 - не должны (включая near-miss сценарии, где формулировка похожа, но задача другая).
В терминах вайб-кодера это переводится так: после того как написал description, открой пустой чат и попробуй на 5 фразах, которые ты реально говоришь, плюс на 3 фразах, которые похожи, но другие. Если навык не подхватился где надо или подхватился, где не надо - правь description. И только после этого пиши тело инструкции.
Какие 5 skills я бы поставил первыми?
Тратить первые две недели на написание своих skills - проигрышная стратегия. Сначала ставишь готовые, смотришь как они устроены, потом дописываешь свои в той же логике. Дешевле взять чужие проверенные наборы и кастомизировать под себя, чем собирать всё с нуля. Вот пять наборов, с которых я бы начал:
1. anthropics/skills - официальный набор с skill-creator
Репозиторий: github.com/anthropics/skills. 138 000 звёзд на GitHub. Внутри - официальные skills от команды Anthropic: skill-creator (мета-навык, который пишет другие skills), claude-api (помогает строить интеграции с API), готовые document skills для PowerPoint, Excel, Word, PDF.
Установка через Claude Code:
/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills
/plugin install example-skills@anthropic-agent-skillsГлавная ценность - skill-creator. Он сам пишет SKILL.md по твоему описанию, потом прогоняет через 20 trigger-evals и правит description, пока навык не начнёт активироваться где надо. По сути это «навык, чтобы создавать навыки».
2. mattpocock/skills - вирусный набор от TypeScript-эксперта
Репозиторий: github.com/mattpocock/skills. На май 2026 - около 94 000 звёзд, 8 300 форков. Matt Pocock - один из самых цитируемых TypeScript-экспертов, автор обучающего проекта Total TypeScript. Он выложил свою .claude/ директорию без анонса и без блог-поста - и за сутки попал в топ trending на GitHub с десятками тысяч звёзд (по byteiota.com).
Внутри 12 активных skills, главные из них:
grill-me- задаёт вопросы по дереву решений, пока неопределённости в задаче не закроются. Главная боль вайб-кодера - «не знаю чего хочу» - закрывается этим навыком в первой итерации.caveman- сжимает коммуникацию модели до телеграфного стиля. Независимая проверка andrew.ooo показала 62% сокращения выходных токенов в 30-ходовой отладочной сессии без потери точности. Заявка автора - до 75%.diagnose- отладка по циклу reproduce - minimize - hypothesize - instrument - fix - regression-test. Pocock пишет: «большинство агентов пропускают шаги 1 и 6».tdd- принудительно запускает red-green-refactor: сначала падающий тест, потом минимальный фикс, потом рефакторинг.to-issues- превращает план в вертикально нарезанные GitHub-issues (full-stack, deployable независимо).
Установка:
npx skills@latest add mattpocock/skills
/setup-matt-pocock-skills3. coreyhaines31/marketingskills - набор для маркетолога
Репозиторий: github.com/coreyhaines31/marketingskills. Около 29 500 звёзд, 4 800 форков. Самый релевантный набор для аудитории «не разработчик» - десятки маркетинговых skills: SEO-аудит сайта, copywriting по AIDA/PAS-формуле, CRO-анализ посадочной страницы, retention-механики email-рассылок, аналитика конверсий.
Если ты ведёшь онлайн-программы, работаешь маркетологом-фрилансером или агентство - тут можно не писать свои навыки полгода. Половина задач уже упакована.
4. vercel-labs/agent-skills - дизайн без ИИ-эстетики
Репозиторий: github.com/vercel-labs/agent-skills. Главный навык внутри - web-design-guidelines, около 133 000 еженедельных установок (статистика по firecrawl.dev). Аудитит UI-код по 100+ правилам доступности, производительности и удобства.
Параллельно - Anthropic frontend-design с более 110 000 еженедельных установок. Принудительно проводит ИИ через выбор стиля до того, как начнёт писать код. Без этого каждая страница, которую генерит Claude - это шрифт Inter, фиолетовый градиент и grid-карточки. Один и тот же результат у всех.
Один из практиков, тестировавший десятки skills (Om Patel в X-треде), формулирует это так: без frontend-design каждый лендинг на Claude выходит одинаковым - шрифт Inter, фиолетовый градиент, сетка карточек. Скилл заставляет выбрать настоящее дизайн-направление, а не дефолт.
5. obra/superpowers - multi-agent workflow
Репозиторий: github.com/obra/superpowers. Около 198 000 звёзд - один из самых популярных публичных наборов skills вообще. Внутри - связка skills для планирования, TDD, code-review, которые работают параллельно. Если твой проект сложнее одного скрипта - сюда стоит заглянуть, чтобы посмотреть как разработчики строят свою «команду из ИИ-агентов».
В целом, если ты ставишь первые три из этого списка - anthropics/skills, mattpocock/skills и coreyhaines31/marketingskills - в твоём Claude Code появится несколько десятков готовых навыков, которые покроют большую часть задач предпринимателя за первый месяц.
Хочешь не только установить готовые skills, но и собрать связку, которая делает Claude по-настоящему твоим помощником? Skills - один из трёх китов методологии. На практикуме за 3 эфира разбираем все три: ИИ-клон (Skills как упакованная экспертиза) + Второй мозг (структура знаний для контекста) + Контекст-инжиниринг (как Claude видит проект целиком). Эта связка превращает Claude из помощника, который угадывает, в инструмент, который думает в твоей логике.
Какие повторяющиеся задачи стоит превратить в skill?
В работе с клиентами и в чужих проектах я видел этот паттерн десятки раз. У человека есть «то, что он каждый раз делает заново». Каждый понедельник пишет один и тот же тип отчёта. Каждый раз при заходе нового клиента прогоняет одинаковую процедуру. Каждую публикацию верстает по одному шаблону. И каждый раз это занимает 30-90 минут, потому что заново вспоминаешь шаги, заново открываешь нужные файлы, заново формулируешь запрос Claude.
Решение - один раз упаковать это в skill. Дальше ты говоришь одну фразу, Claude сам подгружает методологию, читает нужные источники, выдаёт результат. Три примера из разных ниш:
Пример 1. Маркетолог-фрилансер - skill weekly-content-plan
Что делает руками: каждый понедельник для трёх клиентов готовит план постов в Telegram на неделю. Открывает базу с голосом бренда клиента, смотрит последние посты, прикидывает темы по продуктовому календарю, рисует таблицу с зацепом и буллетами.
В skill это превращается в инструкцию из 5 шагов: прочитать файл с tone of voice клиента, прочитать продуктовый календарь, проверить последние 10 постов на повторы, сформировать 7 тем с разбивкой по типам (продающие, экспертные, личные), выдать таблицу.
Команда «давай план постов для клиента X на неделю» вместо часа подготовки превращается в три минуты ожидания. Маркетолог проверяет результат, правит точечно, отправляет клиенту.
Пример 2. Бухгалтер на аутсорсе - skill monthly-receipts-close
Что делает руками: пул клиентов-ИП, каждый месяц по каждому - выгружает выписку из банка, сверяет с поступлениями в учётной системе, выделяет нерасшифрованные платежи, формирует предварительный КУДиР, сравнивает с прошлым месяцем по структуре доходов.
В skill это инструкция из 6 шагов плюс пара shell-скриптов в папке scripts/ для парсинга банковских выписок. Триггер «закрой май для клиента X» - и за 4-5 минут Claude выдаёт готовый отчёт с поднятыми флагами по аномалиям.
Пример 3. Автор онлайн-программ - skill welcome-letter-new-participant
Что делает руками: новый участник оплатил, нужно написать ему welcome-email. Хороший welcome - персональный: учесть из какого канала пришёл, что за продукт купил, на какой поток, какие материалы выслать вместе. Шаблон «здравствуй, мы рады» этого не даёт.
В skill - инструкция читать knowledge/audience.md (кто эти люди), knowledge/products/<продукт>.md (что они получают), последние три welcome-письма (чтобы не повторяться) и формировать письмо по структуре зацеп - конкретика про продукт - три первых шага - подпись.
В разы быстрее, чем руками. Качество - стабильнее, потому что Claude не забывает заглянуть в три источника, тогда как человек на бегу пропускает один из них.
Что НЕ стоит делать skill
- Разовые задачи. Если делаешь это раз в год при подаче декларации - просто опиши Claude задачу в чате. Skill окупается на 3+ повторении.
- Слишком общие задачи. «Помоги мне с маркетингом» - не skill, это весь маркетинг. Skill - это «контент-план на неделю», конкретное действие с конкретным результатом.
- Задачи, в которых нет повторяемости в шагах. Если каждый раз процесс другой - это не skill, это разовая работа.
Как Skill Creator пишет skills за тебя?
Подвох в том, что хороший skill самому написать с первого раза сложно. Description часто получается то слишком узким, то слишком широким, не покрывает реальных формулировок юзера, конфликтует с соседним навыком. Anthropic предусмотрел это и выпустил skill-creator - мета-skill, который умеет создавать другие skills.
После установки anthropics/skills ты говоришь Claude /skill-creator (или просто «давай сделаем skill для еженедельного отчёта») - и проходишь воркфлоу из 6 этапов:
- Draft - skill-creator задаёт вопросы: что должен делать навык, какие триггер-фразы, какие источники читать, какие шаги выполнять. На выходе - первая версия SKILL.md.
- Test - skill-creator сам генерит 20 тестовых промптов: 10 которые должны триггерить навык, 10 которые похожи на триггер, но не должны (near-miss).
- Evaluate - прогоняет каждый промпт через свежий чат, смотрит, активировался ли навык. Если активировался не там или не активировался где надо - помечает.
- Iterate - переписывает description с учётом провалов, прогоняет тесты ещё раз.
- Optimize - финальная полировка: проверяет, не превышен ли лимит 1024 символа, нет ли конфликтов с существующими skills проекта.
- Package - упаковывает финальный SKILL.md плюс reference-файлы в правильную структуру.
В реальной работе это выглядит так: разговариваешь с Claude 15-20 минут, отвечаешь на 7-8 уточняющих вопросов, в конце получаешь готовый протестированный skill, который сразу подхватывается на нужных триггерах.
Дополнительный плюс - skill-creator показывает образцовый стиль написания SKILL.md. Можно открыть его собственный файл и подсмотреть формат, тон, структуру шагов. Это тот случай, когда инструмент сам себя демонстрирует - читаешь его и учишься писать свои.
Skills, CLAUDE.md, Subagents, MCP, Hooks - когда что брать?
Самый частый затык в проектах, которые я разбирал - в CLAUDE.md лежат и правила проекта, и пошаговые инструкции по публикации, и шаблон коммита, и описание базы. Это перегружает контекст и одновременно не работает: Claude не запускает инструкцию «когда юзер просит публикацию», потому что для модели весь CLAUDE.md - это «общий контекст», без явных триггеров.
Решение - разнести по правильным примитивам:
| Что | Когда брать | Пример |
|---|---|---|
| CLAUDE.md | Знание, которое нужно ВСЕГДА | «У нас RU-локализация», «не длинное тире в текстах», «бренд пишется через "о"» |
| Skills | Воспроизводимый процесс по триггеру | «Публикация в прод», «план постов на неделю», «закрой месяц у клиента» |
| Subagents | Параллельное выполнение или изоляция тяжёлого контекста | «Аудит безопасности пока я планирую новую фичу», «обзор кодобазы в отдельной сессии» |
| MCP | Подключение внешней системы | «Получить данные из CRM», «вытащить задачи из трекера», «проверить сайт в браузере» |
| Hooks | Автоматическая реакция на событие | «Авто-проверка после Edit», «блокировка опасных команд», «уведомление в Telegram по завершении» |
В разборе примитивов Claude Code от Alex Op («Understanding Claude Code's Full Stack») картина сводится к простой логике: Skills и MCP закрывают большую часть рабочих процессов, Hooks автоматизируют рутину - проверки кода, тесты, защитные ограничения. Subagents нужны, когда контекст становится тяжёлым. Самая частая ошибка - создавать subagent там, где должен быть skill.
Дерево решений
Когда возникает идея «надо чтобы Claude делал X»:
- Это знание, которое нужно всегда? Например, «у нас RU-локализация» или «не используем em-dash». → Положи в
CLAUDE.md. - Это процедура с триггером, которую делаешь руками сейчас? Например, «каждый понедельник пишу отчёт». → Делай skill.
- Тебе нужен доступ к внешней системе? Например, к Stripe API или к твоей CRM. → Подключай MCP server.
- Нужно автоматически реагировать на событие в Claude Code? Например, после каждого Edit запускать линтер. → Пиши hook.
- Задача тяжёлая, съест весь контекст, и параллельно нужно делать что-то другое? → Запускай в subagent.
90% задач предпринимателя-вайб-кодера попадают в категории 1-3. Hooks и subagents - инструменты следующего уровня, когда выйдешь из режима «одна задача за раз».
Slash-команды и skills - это одно и то же
В Claude Code произошло важное изменение: старая система slash-команд (.claude/commands/) и skills фактически слились. Файл .claude/commands/deploy.md и .claude/skills/deploy/SKILL.md оба создают команду /deploy. Если имена совпадают - skill выигрывает. Так что если ты ещё работаешь со старым форматом slash-команд - переноси в skills, синтаксис понятнее и возможностей больше.
7 ошибок, из-за которых skill не срабатывает
1. Description без триггеров - skill не активируется
Симптом: написал skill, проверил структуру, всё валидно, но Claude его не вызывает на запросы юзера. Причина почти всегда одна - description в стиле «Helper for content writing». Claude не понимает, на какие фразы реагировать. Лечение: пропиши 3-5 реальных фраз пользователя в кавычках прямо внутри description.
2. SKILL.md больше 500 строк - внимание рассеивается
Anthropic рекомендует прямо держать тело файла в пределах 500 строк. Если у тебя инструкция на 2000 строк, Claude теряет фокус, выполняет шаги частично, путается в последовательности. Лечение: вынеси большие куски в файлы рядом - examples/, references/, scripts/ - и в SKILL.md только ссылайся на них.
3. Один skill на «всё про контент» вместо трёх маленьких
Соблазнительная схема: один большой skill content, в нём - и посты в Telegram, и лендинги, и email. Не работает. Skill активируется не на тех запросах, путает методологии, выдаёт усреднённый результат. Лечение: один skill = одно повторяющееся действие. Если на тему «контент» у тебя реально три рутины - значит три навыка: telegram-post, landing-section, email-broadcast.
4. Skill без блока «когда НЕ применять» - конфликты
Симптом: два похожих skills в проекте, и Claude вызывает не тот. Например, один навык про email-рассылку, другой про welcome-email конкретно для участников программы. Без явного «не активируйся, если речь про общую рассылку базе» welcome-email будет триггериться по любому слову «email». Лечение: в description явно прописать negative-кейсы.
5. 50 skills в проекте - описания обрезаются
All skill names are always included, but if you have many skills, descriptions are shortened to fit the character budget, which can strip the keywords Claude needs to match your request. The budget scales at 1% of the model's context window.
Если ты скачал 50 наборов skills с маркетплейса - часть описаний будет усечена. Ключевые слова, на которые ты рассчитывал, могут исчезнуть. Лечение: держи в активном проекте 10-15 самых нужных. Остальные - в личной библиотеке ~/.claude/skills/, ставь только когда нужны.
6. Skills из непроверенных источников - риск безопасности
Anthropic об этом предупреждает в официальной документации:
Use Skills only from trusted sources: those you created yourself or obtained from Anthropic. A malicious Skill can direct Claude to invoke tools or execute code in ways that don't match the Skill's stated purpose.
Случайный repo на GitHub может содержать skill, который при первом вызове сольёт твои API-ключи. Лечение: перед установкой открой SKILL.md и прочитай руками что внутри. Не запускай навыки от незнакомых авторов в важных проектах.
7. Skill без папки знаний выдаёт «среднего ChatGPT»
Самый тонкий и распространённый антипаттерн. Skill - это методология, но методология сама по себе ничего не значит без контекста. Если ты пишешь skill «сделай welcome-email», но в проекте нет файла с описанием аудитории и нет файла с голосом бренда - Claude напишет среднее ChatGPT-письмо, не отличимое от чужого.
Skill работает на полную, только когда у тебя уже собран Второй мозг проекта по канону из гайда про CLAUDE.md. Сначала структура знаний, потом навыки, которые на неё опираются. Перевернуть порядок - получишь рутинное среднее качество вместо персонализированной работы в твоём стиле.
Как собрать первый skill за 30 минут?
Конкретный план, по которому я разворачивал первые навыки в своих проектах:
Шаг 1. Выбери одно повторяющееся действие
Открой свой календарь за последний месяц. Найди задачу, которую делал минимум 4-5 раз и которая занимает 30-60 минут каждый раз. Не глобальное «маркетинг», а конкретное: «отчёт по продажам в понедельник», «приёмка нового клиента», «обновление прайса под акцию».
Чем уже формулировка - тем проще будет skill и тем чище триггер.
Шаг 2. Распиши процесс руками
В отдельном файле или в чате с Claude (не для skill, а для черновика) распиши шаги, которые ты делаешь:
1. Открываю базу клиентов
2. Фильтрую по статусу "ожидает welcome-email"
3. Смотрю из какого канала пришёл клиент
4. Беру шаблон письма для этого канала из папки "шаблоны"
5. Подставляю имя, продукт, дату старта
6. ОтправляюПока это не skill, это конспект. Но без этого конспекта писать SKILL.md - значит сразу путаться.
Шаг 3. Создай структуру папки
mkdir -p .claude/skills/welcome-email-new-client
touch .claude/skills/welcome-email-new-client/SKILL.mdИли, если хочешь использовать навык во всех своих проектах - в ~/.claude/skills/.
Шаг 4. Напиши SKILL.md по шаблону
Скелет:
---
name: welcome-email-new-client
description: |
Готовит welcome-email новому клиенту по шаблону его канала привлечения.
Триггеры: "напиши welcome для нового клиента X",
"приём нового участника Y", "welcome-email для клиента из канала Z".
Не активируйся, если речь про общую рассылку базе
или про email-кампанию - это другие навыки.
---
# Welcome Email для нового клиента
## Шаги
1. Прочитай `knowledge/audience/segments.md` - какие у нас сегменты клиентов
2. Прочитай `knowledge/templates/welcome/` - шаблоны по каналам
3. Определи канал клиента из контекста запроса
4. Подставь имя клиента, название продукта, дату старта
5. Проверь длину - должно быть не больше 800 символов
6. Выведи итоговый текст письма в формате готовом к копированию
## Важно
- Не используй слова «дорогой друг», «здравствуйте» - живая речь
- Один абзац - одна мысль
- В конце - один призыв к действию, не дваШаг 5. Протестируй на 5-8 промптах
Открой пустой чат с Claude Code в этом проекте. Попробуй 5 формулировок, которые ты реально говоришь, и 3 похожих, на которые навык не должен реагировать:
Должны триггерить:
- «Напиши welcome для нового клиента Иванова»
- «Приём нового участника, который купил программу X»
- «Welcome-email для клиента из Instagram»
Не должны триггерить:
- «Сделай рассылку всей базе про скидку»
- «Email-кампания на новогодние праздники»
- «Напиши follow-up клиенту, который не оплатил»
Смотри в каждом случае - активировался ли skill. Если активировался не там - надо сузить description. Если не активировался где надо - расширить триггер-фразы.
Шаг 6. Итерируй description
После каждого провального теста правишь только description - тело инструкции не трогай. Через 2-3 итерации навык начинает срабатывать чисто. Сохрани, закоммить, дальше используй ежедневно.
Финальный совет: первый skill не пытайся сделать идеальным. Сделай работающим. Полировка приходит после пятого-десятого навыка, когда ты уже видишь паттерны в своих формулировках и в реакциях Claude.
Возьми один повторяющийся таск из своего календаря на эту неделю, выдели 30 минут и пройди по 6 шагам выше. Дальше Claude уже работает по твоей методологии, а не угадывает.
Источники
- Extend Claude with skills - Claude Code Documentation
- Agent Skills overview - Claude Platform Documentation
- Equipping agents for the real world with Agent Skills - Anthropic Engineering Blog
- anthropics/skills - официальный репозиторий с skill-creator
- Skill Creator SKILL.md - источник методики trigger-evals
- mattpocock/skills - вирусный набор от Matt Pocock
- Matt Pocock skills review - независимая проверка эффекта caveman 62%
- Best Claude Code Skills for 2026 - статистика по установкам и популярности
- coreyhaines31/marketingskills - маркетинговые навыки для вайб-кодеров
- obra/superpowers - multi-agent workflow
- vercel-labs/agent-skills - design guidelines
- Understanding Claude Code's Full Stack - сравнение примитивов
- Om Patel - рекомендации топ-skills для production
- Boris Cherny - анонс /simplify и /batch в Claude Code
- How Boris Cherny Uses Claude Code - workflow от автора
- How Allie K. Miller Uses Claude Code - кейс применения skills для daily workflow
- Agent Skills открытый стандарт - спецификация
Полная схема по вайб-кодингу за вечер - ИИ-клон + Второй мозг + Контекст-инжиниринг. Три кита, которые я разбираю в практикуме по очереди.

