# Claude Code Skills в 2026: создание и настройка навыков > Как создавать Skills для Claude Code: устройство SKILL.md, формула description, официальные наборы Anthropic, типичные ошибки и пошаговая сборка первого навыка. Source: https://ailoot.ai/blog/ru/claude-code-skills-library/ Canonical: https://ailoot.ai/blog/ru/claude-code-skills-library/ Language: ru Publisher: Ailoot (https://ailoot.ai/) Translation: guide-213 Revision: sha256-3976012a340ec4e840efb5687f845e5a74a93c1e43fc1d8c18695e5af626c4a8
Ключевые выводы Claude Code Skills — это папки с файлом SKILL.md, который Claude добавляет в контекст по мере необходимости. Файл CLAUDE.md остаётся в памяти постоянно и расходует контекстные токены, тогда как навык загружается при совпадении с запросом. Поэтому в одном проекте могут одновременно использоваться десятки навыков. Ключевой элемент — поле description: по нему Claude определяет, когда включить навык. В статье рассмотрим устройство SKILL.md, составление description, официальные наборы и создание первого навыка примерно за 30 минут.
[Документация Ailoot: API, ключи и подключение](https://ailoot.ai/docs/). ## Что такое Skill в Claude Code и чем он отличается от длинного промпта?
Ключевые выводы Skill — это папка с файлом SKILL.md, где описано, в каких случаях и каким образом применять определённую методику. Anthropic сравнивает такой файл с инструкцией для нового сотрудника: вместо ежедневных напоминаний о каждом действии ему выдают регламент, который он использует по ситуации. В отличие от CLAUDE.md, skill попадает в контекст только при необходимости, поэтому множество навыков может находиться в проекте без постоянной нагрузки на бюджет токенов.
Claude Code Skills — встроенная функция Claude Code, которую Anthropic представила в октябре 2025 года для тарифов Pro, Max, Team и Enterprise. Позже спецификация [Agent Skills](https://agentskills.io) стала открытым стандартом, применимым не только к 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, затем обычные инструкции. Когда пользователь просит развернуть приложение в production, Claude сопоставляет запрос с description навыка `deploy-to-prod`, загружает содержимое SKILL.md и выполняет описанные там действия. ### Три уровня постепенной загрузки Навыки Anthropic устроены так, что информация добавляется в контекст по уровням и только по мере надобности. В Anthropic Engineering этот подход назван «основным принципом проектирования, который делает Agent Skills гибкими и масштабируемыми» ([Anthropic Engineering](https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills)). Выделяют три уровня загрузки: 1. **Метаданные (всегда)** — при начале сессии Claude получает только `name` и `description` каждого навыка. Ориентир по объёму — около 100 токенов на один skill. 2. **Инструкции (при совпадении с запросом)** — если запрос пользователя связан с навыком, в контекст добавляется текст SKILL.md. Ориентир — менее 5000 токенов. 3. **Ресурсы (по запросу)** — примеры, шаблоны, наборы данных и другие приложенные файлы читаются, когда модель обращается к ним. Для этого уровня отдельный лимит не указан. Раньше в [CLAUDE.md](https://ailoot.ai/blog/ru/kak-nastroit-claude-md/) часто собирали всё, что модель должна учитывать. Но большой список, например из 50 правил, быстро занимает значительную часть контекста. При использовании skills в стартовый контекст попадают только их описания, поэтому в проекте можно разместить множество навыков. ### Четыре уровня размещения skills | Уровень | Путь | Для чего применяется | |------------|-----------------------------------|--------------------| | Enterprise | Управляемые настройки организации | Для всех пользователей компании | | Personal | `~/.claude/skills/<имя>/SKILL.md` | Для всех личных проектов | | Project | `.claude/skills/<имя>/SKILL.md` | Для текущего проекта | | Plugin | `/skills/<имя>/SKILL.md` | В проектах, где включён плагин | Enterprise-настройки имеют приоритет над personal, а personal — над project. Плагины используют пространство имён вида `plugin-name:skill-name`, что позволяет избежать совпадений. Общие профессиональные навыки можно хранить в `~/.claude/skills/`, а предназначенные для одного проекта — в `.claude/skills/` его репозитория. ## Из каких частей состоит SKILL.md?
Ключевые выводы SKILL.md — Markdown-файл с YAML-frontmatter в начале и инструкцией в основной части. Для минимального варианта нужны два поля: name длиной до 64 символов и description длиной до 1024 символов. Полная схема может также включать allowed-tools, disable-model-invocation, paths, context: fork, agent и hooks. Anthropic советует ограничивать инструкцию 500 строками, а дополнительные материалы хранить в соседних файлах references.
Простейший вариант занимает около двадцати строк: ```markdown --- name: weekly-content-plan description: Готовит план постов на неделю для Telegram-канала и коротких видео. Триггеры - "сделай план постов", "что постить на этой неделе", "план в канал на 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 распознал запрос о недельном плане публикаций, прочитал названные файлы и подготовил таблицу. ### Ограничения, которые важно учитывать В [официальной документации Claude API](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview) указаны следующие ограничения: - **`name`**: не более 64 символов; разрешены строчные буквы, цифры и дефис, XML-теги недопустимы. Имена `anthropic` и `claude` зарезервированы. - **`description`**: обязательное поле длиной до 1024 символов; XML-теги использовать нельзя. - **Бюджет списка навыков**: в Claude Code описания всех skills в совокупности занимают около 1% контекстного окна. Если навыков много, описания могут обрезаться, из-за чего исчезнут слова, нужные для сопоставления с запросом. - **Текст SKILL.md**: Anthropic советует придерживаться объёма до 500 строк. Более длинные материалы можно перенести в `references/`, `scripts/` и `examples/`, а в основной инструкции указать, когда к ним обращаться. После автоматического сжатия контекста командой `/compact` Claude сохраняет первые 5000 токенов каждого ранее вызванного навыка. Общий бюджет повторно подключаемых skills составляет 25 000 токенов. Если навык превышает доступный объём, часть его инструкций может не учитываться. ### Все поля frontmatter Минимальная конфигурация состоит из `name` и `description`, но в рабочих skills встречаются и другие поля: | Поле | Назначение | Пример | |----|----|----| | `name` | Имя навыка; если поле пропущено, используется имя папки | `deploy-to-prod` | | `description` | Условие для автоматического вызова | Формула приведена ниже | | `when_to_use` | Дополнительные фразы для активации | `["задеплой", "выкатим"]` | | `allowed-tools` | Инструменты, доступные без запроса разрешения | `["Read", "Bash(npm run build)"]` | | `disable-model-invocation` | `true` — запускать может только пользователь | Для потенциально опасных действий | | `user-invocable` | `false` — вызвать навык может только Claude | Для фоновых знаний | | `paths` | Glob-шаблоны файлов, для которых действует навык | `["src/**/*.ts"]` | | `context: fork` | Выполнение в отдельном изолированном контексте | Если требуется тяжёлый контекст | | `agent` | Тип запускаемого subagent | `Explore`, `Plan`, `general-purpose` | | `effort` | Уровень reasoning | `low`, `medium`, `high`, `xhigh`, `max` | | `model` | Модель, которой передаётся skill | `claude-opus-4-7` | | `hooks` | Обработчики событий жизненного цикла навыка | См. раздел о hooks | Для операций, которые нельзя запускать автоматически, следует добавить `disable-model-invocation: true`. Например, навык `deploy-to-prod` с этим параметром запускается, только если пользователь явно введёт `/deploy-to-prod`. Без такого ограничения Claude может решить, что готовый код пора развернуть. ## Почему description определяет большую часть успеха и как его составить?
Ключевые выводы Description — единственное поле, которое Claude видит при старте сессии. Неудачная формулировка может помешать вызову навыка, даже если основная инструкция написана хорошо. Рабочее описание включает три компонента: назначение, фразы-триггеры в кавычках и ситуации, в которых навык применять не следует. В `skill-creator` Anthropic советует делать формулировки немного настойчивыми, поскольку Claude может не вызвать подходящий навык.
Часто начинающие пишут description вроде «Помощник для X». Папка и инструкция существуют, но Claude не понимает, при каких запросах навык следует использовать. ### Неудачный вариант description ```yaml description: Build dashboards. ``` Из такой записи неясно, относится ли к созданию dashboard просьба показать продажи за неделю, построить график выручки или подготовить месячный отчёт. В `skill-creator` Anthropic эта рекомендация сформулирована так:

У Claude может быть склонность не вызывать skills даже в подходящих ситуациях. Чтобы уменьшить вероятность этого, делайте описания навыков немного более настойчивыми.

— Anthropic Skill Creator (SKILL.md), https://github.com/anthropics/skills/blob/main/skills/skill-creator/SKILL.md
### Формула хорошего description Включите три части: 1. **Что делает навык** — одно предложение о результате, а не о процессе. Например, не «создаёт SQL», а «собирает данные о продажах в таблицу для Telegram-канала». 2. **Когда его запускать** — от трёх до пяти фраз в кавычках, отражающих реальные запросы пользователей. Их можно найти в истории чатов или обращений в поддержку. 3. **Когда не запускать** — одна-две фразы о похожих задачах, которые не относятся к этому навыку. Это помогает не путать близкие skills. Пример описания для вымышленного проекта: ```yaml description: | Пишет и публикует SEO-гайд в блог по канону редполитики. Триггеры: "напиши гайд про X", "давай новый pillar", "статья в блог про Y", "build blog guide про Z". Не активируйся, если речь про email-рассылку, пост в Telegram или внутреннюю инструкцию команды - это другие навыки. ``` Здесь полезны несколько решений: - Вместо общего «помогает» используется конкретное действие — «пишет и публикует». - Четыре фразы-триггера охватывают разные варианты запроса. - Добавлен триггер на английском: он может помочь распознать команду, если пользователь переключится на этот язык. - Блок «не активируйся» отделяет навык от навыков для рассылок и публикаций в Telegram. ### Как проверить description В `skill-creator` Anthropic описана методика trigger-evals: проверка на 20 промптах, из которых 10 должны вызывать навык, а 10 — не должны. Во вторую группу входят близкие по формулировке ситуации, где задача на самом деле другая. Для самостоятельной проверки можно открыть новый чат и ввести пять привычных запросов, а затем три похожих, но не относящихся к навыку. Если навык не включился при нужном запросе или сработал лишний раз, скорректируйте description. После проверки можно переходить к написанию основной инструкции. ## Какие skills установить в первую очередь?
Ключевые выводы Предпринимателю может быть удобно начать с готовых коллекций и адаптировать их под свои задачи. Anthropic и Vercel публикуют наборы, устанавливаемые одной командой и предназначенные, среди прочего, для работы с документами и дизайном. По данным на май 2026 года, в официальном репозитории `anthropics/skills` было около 138 000 звёзд.
Вместо того чтобы сразу писать навыки с нуля, можно изучить готовые официальные примеры, установить подходящие и настроить их для себя. Для начала подойдут опубликованные Anthropic коллекции: ### 1. anthropics/skills — официальный набор и skill-creator Репозиторий: [github.com/anthropics/skills](https://github.com/anthropics/skills). На май 2026 года в нём было около 138 000 звёзд GitHub. В коллекцию входят skills от Anthropic: `skill-creator` для создания навыков, `claude-api` для разработки интеграций с API, а также навыки для работы с 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. vercel-labs/agent-skills — рекомендации по веб-дизайну Репозиторий: [github.com/vercel-labs/agent-skills](https://github.com/vercel-labs/agent-skills). В его составе есть `web-design-guidelines` — инструмент проверки UI-кода по рекомендациям, связанным с доступностью, производительностью и удобством использования. У Anthropic также есть навык [frontend-design](https://github.com/anthropics/skills/tree/main/skills/frontend-design), который предлагает определить направление дизайна до написания кода. Это помогает задать визуальный стиль страницы вместо того, чтобы сразу переходить к типовым решениям. Если устанавливаете навыки из репозитория, сначала откройте его SKILL.md и проверьте содержимое и инструкции. Коллекции Anthropic дают готовые примеры, с которых можно начать, а затем адаптировать навыки под свои рабочие процессы. ## Какие повторяющиеся задачи можно превратить в skill?
Ключевые выводы Кандидатом на skill может стать повторяющаяся операция, которую вы выполняете более двух раз в неделю по примерно одинаковому сценарию. Это может быть подготовка контент-плана, проверка документов клиентов или письмо новому участнику. Разовая задача, например ежегодный отчёт для аудитора, обычно не требует отдельного навыка. Skill позволяет оформить знакомую последовательность действий так, чтобы её можно было повторно использовать.
Если задача регулярно занимает от 30 до 90 минут, потому что приходится заново вспоминать порядок действий, открывать нужные файлы и составлять инструкции для Claude, её процесс можно попробовать оформить в виде навыка. Достаточно один раз описать последовательность. Затем можно сформулировать запрос, а Claude загрузит методику, прочитает указанные источники и подготовит результат. Ниже — три примера из разных областей: ### Пример 1. Маркетолог-фрилансер: skill `weekly-content-plan` Каждый понедельник специалист готовит для трёх клиентов план публикаций в Telegram на неделю. Для этого он открывает материалы о стиле каждого бренда, просматривает последние публикации, сверяется с продуктовыми планами, а затем составляет таблицу с темами и тезисами. В skill этот процесс можно записать как пять действий: прочитать файл о tone of voice, открыть продуктовый календарь, проверить последние десять публикаций на повторы, подготовить семь тем разных типов — продающих, экспертных и личных — и вывести таблицу. Запрос «подготовь план постов для клиента X на неделю» запускает описанный порядок. Специалист проверяет предложенный результат, вносит нужные правки и передаёт его клиенту. ### Пример 2. Бухгалтер на аутсорсе: skill `monthly-receipts-close` Для каждого клиента раз в месяц нужно выгрузить банковскую выписку, сопоставить её с поступлениями в учётной системе, найти нерасшифрованные платежи, подготовить предварительный отчёт о доходах и сравнить структуру с предыдущим месяцем. Такой процесс можно оформить как шесть шагов и добавить в `scripts/` несколько shell-скриптов для обработки выписок. Запрос «закрой май для клиента X» запускает подготовку отчёта с отмеченными несоответствиями. ### Пример 3. Автор онлайн-программ: skill `welcome-letter-new-participant` После оплаты новый участник должен получить персональное приветственное письмо. При его подготовке учитывают канал привлечения, выбранный продукт, поток и материалы, которые нужно приложить. Универсального шаблона с одной приветственной фразой для этого недостаточно. В навык можно включить указания прочитать `knowledge/audience.md` с описанием аудитории, `knowledge/products/<продукт>.md` с информацией о продукте и три последних приветственных письма. Затем следует подготовить текст по схеме: зацеп, сведения о продукте, три первых действия и подпись. Обращение к источникам помогает сделать письмо более последовательным: Claude использует сведения о читателях, продукте и предыдущих письмах, перечисленные в инструкции. ### Для каких задач skill не подходит - **Задачи, которые возникают редко.** Если действие требуется раз в год, например при подаче декларации, его можно описать прямо в чате. Отдельный навык начинает приносить пользу, когда задача повторяется. - **Слишком широкие запросы.** Формулировка «помоги с маркетингом» охватывает множество процессов. Лучше выделить конкретный результат, например план публикаций на неделю. - **Процессы без устойчивого порядка действий.** Если последовательность каждый раз меняется, фиксированный skill может оказаться неудобен. ## Как Skill Creator создаёт навыки?
Ключевые выводы Skill Creator — мета-навык Anthropic, запускаемый командой `/skill-creator`. Он помогает пройти шесть этапов: draft, test, evaluate, iterate, optimize и package. В результате получается SKILL.md, проверенный на 20 trigger-evals: десять должны вызывать навык, ещё десять — оставаться без вызова. Этот инструмент может помочь создать первый skill без ручной работы с YAML-разметкой.
С первого раза бывает непросто подобрать подходящий description: он может быть слишком узким или общим, не учитывать реальные формулировки и пересекаться с описанием другого навыка. Anthropic выпустила [skill-creator](https://github.com/anthropics/skills/blob/main/skills/skill-creator/SKILL.md) — навык, который помогает создавать другие навыки. После установки `anthropics/skills` можно ввести `/skill-creator` или попросить Claude подготовить skill для еженедельного отчёта. Работа включает шесть этапов: 1. **Draft** — skill-creator уточняет, какую задачу решает навык, какие фразы должны его запускать, какие файлы читать и какие действия выполнять. Затем создаёт начальный SKILL.md. 2. **Test** — формирует 20 тестовых промптов: десять для ожидаемого вызова и десять похожих по формулировке запросов, при которых навык включаться не должен. 3. **Evaluate** — проверяет каждый промпт в новом чате и отмечает, где навык активировался, а где нет. 4. **Iterate** — меняет description с учётом ошибок и повторяет проверку. 5. **Optimize** — проверяет, что описание не превышает лимит в 1024 символа и не конфликтует с другими навыками проекта. 6. **Package** — формирует SKILL.md и связанные reference-файлы в требуемой структуре. Обычно для этого требуется ответить на несколько уточняющих вопросов и описать свои рабочие правила. Затем можно получить вариант навыка, который следует проверить на реальных запросах. Файл самого `skill-creator` тоже можно изучить как образец: в нём видны структура SKILL.md, стиль формулировок и порядок шагов. ## Skills, CLAUDE.md, Subagents, MCP и Hooks: что выбрать?
Ключевые выводы В Claude Code есть пять разных механизмов расширения, предназначенных для разных задач. CLAUDE.md хранит постоянные сведения о проекте. Skills задают повторяемые процессы, запускаемые по запросу. Subagents выполняют параллельные задачи в отдельном контексте. MCP подключает внешние системы, например API или базы данных. Hooks запускают действия в ответ на события. Для каждой задачи следует выбрать подходящий механизм, а не помещать всю информацию в CLAUDE.md.
Если в CLAUDE.md одновременно хранятся правила проекта, шаги публикации, шаблоны коммитов и сведения о базе данных, файл разрастается. Кроме того, общая информация сама по себе не задаёт условие, при котором Claude должен запустить конкретную процедуру. Разделить функции можно так: | Что | Когда применять | Пример | |----|----|----| | **CLAUDE.md** | Сведения, необходимые постоянно | «У проекта задан язык», «не используй длинное тире», «название бренда пишется через “о”» | | **Skills** | Повторяемая процедура, запускаемая по запросу | «Публикация в production», «план постов на неделю», «закрыть месяц клиента» | | **Subagents** | Параллельная работа или изоляция большого контекста | «Провести аудит безопасности, пока я планирую функцию», «обзор кодовой базы в отдельной сессии» | | **MCP** | Доступ к внешним системам | «Получить данные из CRM», «загрузить задачи из трекера», «проверить сайт в браузере» | | **Hooks** | Автоматическая реакция на событие | «Запустить проверку после Edit», «заблокировать опасные команды», «отправить уведомление в Telegram после завершения» | Если коротко, Skills и MCP помогают выполнять рабочие процессы, Hooks автоматизируют действия в ответ на события, а Subagents полезны для задач, которым требуется отдельный контекст. Перед созданием нового механизма стоит определить, какое именно действие он должен выполнять. ### Дерево выбора Если вы хотите поручить Claude задачу X, задайте себе следующие вопросы: 1. **Это постоянное знание?** Например, язык проекта или правило не использовать em-dash. → Добавьте его в `CLAUDE.md`. 2. **Это процедура, которую вы повторяете вручную по определённому поводу?** Например, еженедельный отчёт. → Создайте **skill**. 3. **Нужно получить доступ к внешней системе?** Например, к Stripe API или CRM. → Подключите **MCP server**. 4. **Нужна автоматическая реакция на событие в Claude Code?** Например, запуск линтера после каждого Edit. → Настройте **hook**. 5. **Задача требует большого контекста и должна выполняться параллельно с другой работой?** → Запустите её в **subagent**. Многие повседневные задачи сводятся к хранению постоянных сведений, повторяемым процедурам и подключению внешних систем. Hooks и subagents пригодятся, когда рабочий процесс потребует автоматической реакции или изолированного выполнения. ### Slash-команды и skills используют общую механику Старая система slash-команд (`.claude/commands/`) и skills теперь во многом объединены. Файл `.claude/commands/deploy.md` и файл `.claude/skills/deploy/SKILL.md` могут оба создавать команду `/deploy`. При совпадении имён приоритет получает skill. Если проект всё ещё использует старый формат команд, можно перенести их в skills, сохранив назначение. ## Семь причин, по которым skill может не сработать
Ключевые выводы Неполадки с skills часто связаны с настройками самого навыка: в description нет подходящих фраз, SKILL.md слишком велик, несколько навыков пересекаются или установлены материалы из непроверенного источника. Такие ошибки влияют на вызов навыка и качество его работы.
### 1. В description нет фраз-триггеров **Признак:** структура файла верна, но Claude не вызывает навык в ответ на запросы пользователя. Частая причина — описание наподобие «Helper for content writing», в котором не сказано, какие именно фразы должны запускать skill. Добавьте в description от трёх до пяти реальных формулировок запросов в кавычках. ### 2. SKILL.md содержит больше 500 строк Anthropic рекомендует в [документации](https://code.claude.com/docs/en/skills) ограничивать тело файла примерно 500 строками. Если инструкция значительно длиннее, её бывает сложнее выполнять последовательно. Большие примеры и справочные материалы можно вынести в соседние `examples/`, `references/` и `scripts/`, а в SKILL.md указать, когда их читать. ### 3. Один навык охватывает весь контент Может показаться удобным создать один большой skill `content` для постов в Telegram, лендингов и email. Однако у этих задач разные условия запуска и порядок действий, поэтому широкий навык может вызываться не к месту и смешивать подходы. Разделите повторяющиеся операции: например, на `telegram-post`, `landing-section` и `email-broadcast`. ### 4. Не указано, когда навык применять не следует Если в проекте есть два близких навыка, Claude может вызвать неподходящий. Например, описание навыка для приветственного письма новому участнику может пересекаться с общей email-рассылкой. Добавьте в description ситуации, к которым навык не относится. ### 5. В проекте слишком много skills В [документации Claude Code](https://code.claude.com/docs/en/skills) сказано:

Имена skills включаются всегда, но при большом количестве навыков описания обрезаются по лимиту символов. В результате могут исчезнуть ключевые слова, нужные Claude для сопоставления запроса. Бюджет составляет 1% контекстного окна модели.

— Документация Claude Code, https://code.claude.com/docs/en/skills
При установке многих коллекций описания могут усекаться, теряя нужные для активации слова. Оставьте востребованные навыки, остальные храните в неактивном архиве вне всех обнаруживаемых каталогов, например в отдельном `skill-archive/` своих материалов. Устанавливайте только нужное в проектную или личную область. `~/.claude/skills/` — установленная личная библиотека, доступная во всех проектах: перемещение туда не исключает навык из обнаружения. ### 6. Навыки получены из непроверенного источника Anthropic предупреждает об этом в [официальной документации](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview):

Используйте навыки из источников, которым доверяете: созданные вами или полученные от Anthropic. Вредоносный skill может побудить Claude запускать инструменты или код способом, не соответствующим его заявленному назначению.

— Обзор Agent Skills от Anthropic, https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview
Перед установкой незнакомого навыка внимательно прочитайте SKILL.md и проверьте, какие инструменты и действия он предусматривает. Не запускайте непроверенные инструкции в важных проектах. ### 7. У навыка нет файлов с нужными знаниями Даже хорошо описанная методика может дать общий результат, если Claude не предоставлены сведения о задаче. Например, навык для приветственных писем будет работать хуже, если проект не содержит описания аудитории и стиля бренда. Подготовьте нужные материалы, например сведения о продукте, целевой аудитории и tone of voice, а затем укажите в инструкции, какие файлы прочитать. Это позволит навыку использовать контекст конкретного проекта. ## Как создать первый skill за 30 минут?
Ключевые выводы Для первого навыка выберите конкретную повторяемую задачу, опишите её шаги, создайте папку и SKILL.md, затем проверьте description на подходящих и похожих запросах. Если навык срабатывает не в тех ситуациях, измените описание и повторите проверку. На первый вариант может потребоваться около 30–40 минут; следующие навыки обычно легче создавать после знакомства с форматом.
Выполните эти действия, чтобы подготовить первый навык: ### Шаг 1. Определите повторяющуюся задачу Посмотрите календарь за последний месяц и выберите действие, которое выполнялось не менее четырёх-пяти раз и занимало от 30 до 60 минут. Сформулируйте его конкретно: например, «отчёт о продажах в понедельник», «приём нового клиента» или «обновление прайса к акции». Чёткая формулировка упрощает и текст навыка, и подбор фраз-триггеров. ### Шаг 2. Запишите последовательность действий В отдельном файле или в чате с Claude составьте черновик процесса. Пока это только заметки для подготовки, а не сам skill: ``` 1. Открываю базу клиентов 2. Фильтрую по статусу "ожидает welcome-email" 3. Смотрю из какого канала пришёл клиент 4. Беру шаблон письма для этого канала из папки "шаблоны" 5. Подставляю имя, продукт, дату старта 6. Отправляю ``` Без такой последовательности будет сложнее определить, что включить в 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 в проекте и попробуйте запросы, которые должны и не должны запускать навык. Должны запускать: - «Напиши welcome для нового клиента Иванова» - «Приём нового участника, который купил программу X» - «Welcome-email для клиента из Instagram» Не должны запускать: - «Сделай рассылку всей базе про скидку» - «Email-кампания на новогодние праздники» - «Напиши follow-up клиенту, который не оплатил» Для каждого примера проверьте, активировался ли skill. Если он запускается при неподходящих запросах, уточните description. Если не срабатывает в нужных случаях, добавьте подходящие триггеры. ### Шаг 6. Скорректируйте description После неудачной проверки меняйте только description, оставляя тело инструкции прежним. Повторяйте проверку, пока навык не будет срабатывать достаточно точно. Затем сохраните и зафиксируйте файл, чтобы использовать его в работе. Не стремитесь сделать первый навык идеальным: начните с работающего варианта и улучшайте его по итогам практического применения. Выберите одну повторяемую задачу на эту неделю и выделите около 30 минут, чтобы пройти шесть шагов. Навык поможет выполнять знакомую процедуру по заранее описанной методике.
### Источники - [Extend Claude with skills — документация Claude Code](https://code.claude.com/docs/en/skills) - [Обзор Agent Skills — документация Claude Platform](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview) - [Equipping agents for the real world with Agent Skills — блог Anthropic Engineering](https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills) - [anthropics/skills — официальный репозиторий с skill-creator](https://github.com/anthropics/skills) - [Skill Creator SKILL.md — методика trigger-evals](https://github.com/anthropics/skills/blob/main/skills/skill-creator/SKILL.md) - [vercel-labs/agent-skills — рекомендации по веб-дизайну](https://github.com/vercel-labs/agent-skills) - [Agent Skills — открытый стандарт](https://agentskills.io)
Если вам нужен доступ к нейросетям через Ailoot, посетите [Ailoot](https://ailoot.ai/). ## Вопросы и ответы ### Становится ли skill неактивным после переноса в ~/.claude/skills/? Нет. Это установленная личная область: навык доступен в ваших проектах. Ненужные пакеты храните в архиве вне всех обнаруживаемых папок навыков, а устанавливайте только требуемые сейчас. ### Как проверить правильное срабатывание description? Попробуйте пять формулировок, которые должны вызвать навык, и три похожие, которые не должны. Используйте новые чаты, записывайте загруженный навык и меняйте описание при пропуске нужного запроса или ложном совпадении. ## Ailoot · Компания и портфель её проектов Ailoot опирается на накопленный опыт работы, большую клиентскую базу, стабильный сервис и постоянный контроль KPI. Компания и портфель её проектов: миллионы клиентов; продажи на миллиарды ежемесячно. Этот опыт Ailoot использует для API-доступа к нейросетям в продуктах клиентов, агентах, приложениях и автоматизациях.