Claude Code Skills в 2026: как собрать библиотеку навыков под себя

Опубликовано 19.05.202622 мин чтенияСредний
Голографический экран CLAUDE.md в центре цифровой архитектуры с разворачивающимися папками навыков.
Что узнаешь
  • Что такое Claude Code Skills и зачем они живут отдельно от CLAUDE.md
  • Как устроен SKILL.md изнутри - frontmatter, лимиты, обязательные поля
  • Формула description, по которой Claude точно подхватит твой skill
  • 5 готовых наборов skills, которые ставятся за 5 минут и закрывают 80% задач
  • 7 ошибок, из-за которых skill лежит мёртвым грузом, и сборка первого за 30 минут
Применить за 30 мин
Сэкономит 8 ч
Средний
73просмотров
Что понадобится

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

Что такое 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).

Три уровня загрузки:

  1. Metadata (всегда) - при запуске сессии Claude видит только name и description каждого skill. Бюджет: примерно 100 токенов на skill.
  2. Instructions (по триггеру) - когда юзер сказал что-то релевантное, Claude грузит тело SKILL.md. Бюджет: меньше 5000 токенов.
  3. Resources (по запросу) - бандлированные файлы (примеры, шаблоны, дата-сеты) подтягиваются только когда модель сама лезет за ними. Бюджет: безлимитный.

Раньше в CLAUDE.md приходилось пихать всё, что ИИ должен «помнить» - и проект на 50 правил быстро упирался в потолок контекста. С skills в одном проекте легко уживаются десятки навыков, потому что в стартовый контекст попадают только их description'ы.

Где живут skills - четыре уровня

УровеньПутьПрименяется к
EnterpriseManaged 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 изнутри?

Минимальный пример - двадцать строк, и навык готов:

markdown
---
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-invocationtrue - только юзер может вызватьДля опасных операций
user-invocablefalse - только Claude может вызватьДля фоновых знаний
pathsGlob-паттерны, где skill активен["src/**/*.ts"]
context: forkЗапуск в изолированном subagentКогда тяжёлый контекст
agentТип subagent для запускаExplore, Plan, general-purpose
effortУровень reasoninglow, medium, high, xhigh, max
modelКакой модели передать skillclaude-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

yaml
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".

Anthropic Skill Creator (SKILL.md), https://github.com/anthropics/skills/blob/main/skills/skill-creator/SKILL.md

Формула хорошего description

Три части:

  1. Что делает - одно предложение про результат, не про процесс. Не «генерирует SQL», а «выгружает продажи в табличку для Telegram-канала».
  2. Когда триггерить - 3-5 фраз в кавычках, как реально просят юзеры. Не угадывай, посмотри в свою историю чатов и саппорта.
  3. Когда НЕ триггерить - 1-2 фразы про похожие задачи, на которые этот навык не должен реагировать. Без этого блока двух близких skills постоянно конфликтуют.

Пример сильного description из моего проекта (упрощено и обезличено):

yaml
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:

bash
/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 независимо).

Установка:

bash
npx skills@latest add mattpocock/skills
/setup-matt-pocock-skills

3. 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 из помощника, который угадывает, в инструмент, который думает в твоей логике.

Практикум по вайб-кодингу
+Твой второй мозг
3 вечера - стек, метод, первый проект
Старт 26–28 мая  ·  2 000 ₽
Записаться →

Какие повторяющиеся задачи стоит превратить в 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 этапов:

  1. Draft - skill-creator задаёт вопросы: что должен делать навык, какие триггер-фразы, какие источники читать, какие шаги выполнять. На выходе - первая версия SKILL.md.
  2. Test - skill-creator сам генерит 20 тестовых промптов: 10 которые должны триггерить навык, 10 которые похожи на триггер, но не должны (near-miss).
  3. Evaluate - прогоняет каждый промпт через свежий чат, смотрит, активировался ли навык. Если активировался не там или не активировался где надо - помечает.
  4. Iterate - переписывает description с учётом провалов, прогоняет тесты ещё раз.
  5. Optimize - финальная полировка: проверяет, не превышен ли лимит 1024 символа, нет ли конфликтов с существующими skills проекта.
  6. 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»:

  1. Это знание, которое нужно всегда? Например, «у нас RU-локализация» или «не используем em-dash». → Положи в CLAUDE.md.
  2. Это процедура с триггером, которую делаешь руками сейчас? Например, «каждый понедельник пишу отчёт». → Делай skill.
  3. Тебе нужен доступ к внешней системе? Например, к Stripe API или к твоей CRM. → Подключай MCP server.
  4. Нужно автоматически реагировать на событие в Claude Code? Например, после каждого Edit запускать линтер. → Пиши hook.
  5. Задача тяжёлая, съест весь контекст, и параллельно нужно делать что-то другое? → Запускай в 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 в проекте - описания обрезаются

Из документации Claude Code:

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.

Claude Code Documentation, https://code.claude.com/docs/en/skills

Если ты скачал 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.

Anthropic Agent Skills Overview, https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview

Случайный 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. Создай структуру папки

bash
mkdir -p .claude/skills/welcome-email-new-client
touch .claude/skills/welcome-email-new-client/SKILL.md

Или, если хочешь использовать навык во всех своих проектах - в ~/.claude/skills/.

Шаг 4. Напиши SKILL.md по шаблону

Скелет:

markdown
---
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 уже работает по твоей методологии, а не угадывает.

Источники

Полная схема по вайб-кодингу за вечер - ИИ-клон + Второй мозг + Контекст-инжиниринг. Три кита, которые я разбираю в практикуме по очереди.

Практикум по вайб-кодингу
+Твой второй мозг
3 вечера - стек, метод, первый проект
Старт 26–28 мая  ·  2 000 ₽
Записаться →
Была инструкция полезна?
Артемий Миллер
Автор
Артемий Миллер
Предприниматель и вайб-кодер

Артемий Миллер - предприниматель и вайб-кодер. Бывший программист, собирает продукты исключительно вместе с ИИ-агентами, без найма разработчиков.

Тема
Как настроить CLAUDE.md в 2026: готовый шаблон и 6 правил
Главная статья темы
Соседние статьи

Связанные инструкции

Как настроить CLAUDE.md в 2026: готовый шаблон и 6 правил

Готовый шаблон CLAUDE.md, 6 правил живого файла и разбор боевого примера действующего бизнеса. Скопировал, вставил, Claude перестал забывать твой проект между сессиями.

26 мин

Claude Code Subagents в 2026: пошаговая инструкция и 5 готовых примеров

Subagents Claude Code - специалисты с собственным контекстом и инструментами, к которым главный чат делегирует узкие задачи. Структура файла, формула description, 5 готовых ролей, антипаттерны и связка с Multi-agent v2 Anthropic.

21 мин

Как не сжечь лимиты Claude Code за день: 8 правил экономии токенов в 2026

Лимит Claude Code упирается в методологию работы с контекстом, тариф здесь вторичен. 8 правил экономии: одна задача - один диалог, плотная CLAUDE.md, план в файле, skills по триггеру, выбор модели и кэш на 90%.

23 мин

Второй мозг в Claude Code: как настроить, чтобы он помнил проект

Иерархия памяти Claude Code, структура второго мозга из 5 частей и git как машина времени. Чтобы агент перестал забывать твой проект каждую сессию и работал на свежем контексте.

21 мин