Skills в Claude Code: учим Claude работать по-вашему

Что такое Skill простыми словами

Представьте: вам нужно сделать презентацию для рабочей встречи. Вы просите Claude помочь и объясняете, что хотите получить.

Через неделю — ещё одна презентация. Вы снова объясняете всё то же самое. Потом ещё одна. И опять. На четвёртый раз думаете: "А можно это не повторять каждый раз?"

Можно. Именно для этого и нужны скиллы.

Skill — это инструкция, которую вы пишете один раз, а Claude сам к ней обращается, когда нужно. Написали — и больше не повторяетесь.

Без скилла — каждый раз объясняете всё заново:

Сделай презентацию. Один тезис — один слайд,
не больше 6 строк на слайде, заголовок крупный,
буллеты короткие, в конце слайд с выводами.
Используй наши фирменные цвета.

Со скиллом — просто говорите, что нужно:

Сделай презентацию про итоги года

Claude видит, что задача связана с презентацией, подхватывает скилл и делает всё по вашим правилам — без напоминаний.

Можно и вызвать скилл явно:

/presentation-style итоги года

Два способа вызова:

1. Автоматически: Claude сам подключает скилл, когда задача совпадает с его описанием
2. Вручную: вы пишете /имя-скилла — и Claude использует его

---

Из чего состоит Skill

Skill — это Markdown-файл SKILL.md. Вот его минимальная структура:

---
name: presentation-style
description: Правила оформления презентаций. Используй когда нужно создать презентацию.
---

Здесь правила и инструкции для Claude.

Всё между --- — это frontmatter (метаданные). Всё после — инструкция.

Ключевые поля frontmatter скилла

| Поле | Обязательно | Что делает | |------|:-----------:|------------| | name | Нет | Имя скилла для вызова через /имя. Если не указано — берётся из имени папки | | description | Рекомендуется | Описание для Claude: когда использовать этот скилл. Чем точнее — тем лучше Claude поймёт, когда его применять автоматически | | disable-model-invocation | Нет | Если true — Claude не будет вызывать скилл сам, только вы вручную через /имя | | argument-hint | Нет | Подсказка для пользователя: что писать после /имя. Например: <тема презентации> |

Важно: Поле description — самое полезное. Именно по нему Claude решает, нужно ли подключить скилл автоматически. Пишите конкретно: "Используй когда нужно создать презентацию" лучше, чем "Полезный скилл".

Есть более продвинутые поля — подробнее о них можно прочитать в документации.

---

Где хранятся скиллы

Скиллы могут храниться по-разному — в зависимости от того, где они нужны.

Проектные скиллы видит только этот проект — другие проекты (папки) о них не знают. Персональные скиллы доступны везде — в любом проекте, где вы откроете Claude Code.

| Тип | Где лежит | Когда использовать | |-----|-----------|-------------------| | Проектные | В папке проекта: .claude/skills/имя-скилла/SKILL.md (например, my-project/.claude/skills/presentation-style/SKILL.md) | Правила нужны только в этом проекте | | Персональные | В домашней папке компьютера: ~/.claude/skills/имя-скилла/SKILL.md | Правила нужны во всех проектах |

Допустим, вы работаете в агентстве и ведёте несколько клиентов.

Проектные скиллы — у каждого клиента свои:

• Презентация для "АльфаБанка" — строгий стиль, корпоративные цвета, формальный тон
• Презентация для стартапа — яркий дизайн, неформальный тон, много визуала

Персональные скиллы — то, что вы используете везде:

• Ваш стиль подачи — структура аргументации, которую вы используете в любой презентации
• Правила визуализации данных — как оформлять графики и таблицы

---

Какие бывают скиллы

После frontmatter можно писать что угодно — любые инструкции, правила, шаги, примеры. Но базово выделяют два типа скиллов.

Скилл-референс — знания и правила, которые Claude применяет к вашей работе. Стиль оформления, гайдлайны, соглашения. Claude подхватывает их сам, когда задача подходит.

---
name: presentation-style
description: Правила оформления презентаций
---

При создании презентации:
- Один тезис — один слайд
- Не больше 6 строк текста
- Цифры и факты вместо общих фраз
- Последний слайд — выводы и следующие шаги

Скилл-команда — порядок действий, который вы запускаете вручную через /имя. Деплой, генерация отчёта, создание презентации с нуля. Такие скиллы обычно не нужно запускать автоматически, поэтому добавляют disable-model-invocation: true.

---
name: create-presentation
description: Создать презентацию по теме
disable-model-invocation: true
---

Создай презентацию на тему: $ARGUMENTS

1. Собери данные по теме
2. Сформируй структуру из 6-8 слайдов
3. Наполни каждый слайд контентом
4. Добавь слайд с выводами и следующими шагами

Оба типа — это просто файл SKILL.md. Разница только в содержимом и в том, кто его вызывает — Claude сам или вы.

---

Создаём свой первый Skill: пошагово

Создадим скилл с правилами оформления презентаций.

1. Попросите Claude создать скилл

Проектный скилл (будет доступен только в папке этого проекта) — откройте Claude Code в папке нужного проекта:

Создай скилл для оформления презентаций в данном проекте. Правила:
- один тезис — один слайд
- не больше 6 строк текста на слайде
- цифры и факты вместо общих фраз
- последний слайд — выводы и следующие шаги

Персональный скилл (будет доступен в любой папке) — откройте Claude Code в любой папке:

Создай персональный скилл (на уровне пользователя) для оформления презентаций. Правила:
- один тезис — один слайд
- не больше 6 строк текста на слайде
- цифры и факты вместо общих фраз
- последний слайд — выводы и следующие шаги

Claude сам придумает название и создаст файл.

Подсказка: Если хотите, чтобы Claude сначала задал уточняющие вопросы — переключитесь в plan mode (shift+tab до появления режима "Plan") перед отправкой промпта. Claude спросит детали, предложит название и структуру, а создаст скилл только после вашего одобрения. Также можете указать название сами: "Создай скилл с названием presentation-style, который..."

---

2. Перезапустите Claude Code

Скиллы загружаются при запуске. Чтобы новый скилл подхватился:

/exit

Затем:

claude

---

3. Используйте скилл

Просто попросите сделать презентацию:

Сделай презентацию: результаты работы команды за Q4

Claude увидит, что у него есть скилл про презентации, и автоматически применит правила.

Или вызовите напрямую:

/presentation-style результаты работы команды за Q4

---

4. Что вы должны увидеть

Claude создаст структуру презентации, следуя правилам из вашего скилла — без дополнительных инструкций.

Если этого не произошло — проверьте, что вы перезапустили Claude Code после создания скилла.

---

Что произошло "под капотом"?

Claude создал папку со скиллом и файл SKILL.md внутри.

Если вы создавали скилл для проекта, файл находится в папке проекта:

my-project/.claude/skills/presentation-style/SKILL.md

Если персональный скилл — в домашней папке компьютера:

~/.claude/skills/presentation-style/SKILL.md

В обоих случаях содержимое файла будет примерно таким:

---
name: presentation-style
description: Правила оформления презентаций. Используй когда нужно создать, оформить или переработать презентацию.
---

При создании презентации следуй этим правилам:

## Структура слайда

- Один тезис — один слайд
- Заголовок — главная мысль, а не "Введение" или "Слайд 3"
- Не больше 6 строк текста
- Буллеты короткие, без вводных слов

## Содержание

- Цифры и факты вместо общих фраз ("выросло на 23%" вместо "значительно выросло")
- Каждый слайд отвечает на вопрос "ну и что?"
- Последний слайд — выводы и конкретные следующие шаги

## Формат вывода

Каждый слайд оформляй как:
## Слайд N: [Заголовок-тезис]
- Буллет 1
- Буллет 2
- Буллет 3

Это обычный текстовый файл — можете попросить Claude показать его содержимое и отредактировать правила под себя.

Подсказка: Вы также можете создать скилл вручную — достаточно создать папку и положить в неё файл SKILL.md. Для проектного скилла: my-project/.claude/skills/имя-скилла/SKILL.md. Для пользовательского: ~/.claude/skills/имя-скилла/SKILL.md.

---

Усложняем: добавляем шаблон и фирменный стиль

Простой скилл — один файл с правилами. Но скилл может быть целой папкой с шаблонами, примерами и справочными материалами.

Допустим, вы хотите, чтобы Claude не просто знал правила, а использовал конкретный шаблон презентации и фирменный стиль вашей компании:

presentation-style/
├── SKILL.md              # Правила оформления
├── template.md           # Шаблон: типовая структура из 8 слайдов
└── brand-guidelines.md   # Фирменный стиль: цвета, шрифты, тон

В SKILL.md вы ссылаетесь на эти файлы:

## Дополнительные материалы

- Шаблон структуры презентации: [template.md](template.md)
- Фирменный стиль компании: [brand-guidelines.md](brand-guidelines.md)

Claude подгружает эти файлы только когда нужно — не перегружая контекст каждый раз.

Важно: SKILL.md — точка входа. Держите его компактным (до 500 строк). Тяжёлые материалы выносите в отдельные файлы.

---

$ARGUMENTS — передаём данные в скилл

Когда вы вызываете скилл через /, после имени можно дописать текст:

/presentation-style результаты Q4 для совета директоров

Текст результаты Q4 для совета директоров — это аргумент. Claude получит его вместе с содержимым скилла и поймёт, что именно нужно сделать. Это работает само по себе — ничего специально настраивать не нужно.

Но если вы хотите точнее управлять тем, куда подставляется аргумент, используйте $ARGUMENTS в теле скилла:

---
name: presentation-style
description: Правила оформления презентаций.
argument-hint: <тема презентации>
---

Создай презентацию на тему: $ARGUMENTS

При создании следуй правилам:
...

В этом случае $ARGUMENTS будет заменён на результаты Q4 для совета директоров прямо в тексте инструкции.

Поле argument-hint в frontmatter — подсказка для пользователя. Когда вы начинаете набирать /presentation-style в Claude Code, рядом с именем скилла появится текст из argument-hint:

/presentation-style <тема презентации>

Так сразу понятно, что после имени нужно дописать тему. Без argument-hint вы увидите просто /presentation-style — и придётся вспоминать, что туда передавать.

---

Где искать готовые скиллы

Скиллы не обязательно писать с нуля — есть каталог готовых скиллов, которые можно установить одной командой.

Каталог skills.sh

Откройте skills.sh — это открытый каталог скиллов. Там уже больше 49 000 скиллов: от оформления фронтенда до работы с базами данных. Есть скиллы от сообщества и официальные от Anthropic.

На главной странице — лидерборд с самыми популярными скиллами и поиск.

Кликнув на скилл, вы увидите его описание и команду для установки.

Как установить скилл

На странице любого скилла есть команда установки. Например, для скилла find-skills (он помогает Claude искать и устанавливать другие скиллы):

npx skills add https://github.com/vercel-labs/skills --skill find-skills

Вставьте эту команду в терминал. Установщик спросит несколько вещей:

1. В какие агенты установить — выберите Claude Code (пробелом выбрать, Enter подтвердить):

2. Installation scope — Project (только для этого проекта) или Global (для всех проектов):

3. Installation method — выберите Symlink (Recommended):

4. Proceed with installation? — Yes:

После установки перезапустите Claude Code. Набрав /, вы увидите новый скилл в списке:

Скилл find-skills: пусть Claude ищет скиллы за вас

Один из самых полезных скиллов для старта — find-skills. После установки просто опишите Claude, что вам нужно:

Мне нужен скилл для создания лэндингов

Claude сам найдёт подходящие скиллы в каталоге, покажет список с командами установки и порекомендует лучший вариант:

Попробуйте поискать скиллы для разных задач — экспериментируйте:

Найди скилл для написания постов в соцсетях

Найди скилл для code review

Найди скилл для создания API документации

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

Скилл skill-creator: пусть Claude создаёт скиллы за вас

Ещё один полезный скилл — skill-creator. Он помогает Claude создавать новые скиллы. Установите его:

npx skills add https://github.com/anthropics/skills --skill skill-creator

После установки просто опишите, что вам нужно:

Помоги мне создать скилл для оформления презентаций с помощью skill-creator

Claude сгенерирует готовый скилл на основе вашего описания.

А ещё skill-creator умеет проверять уже существующие скиллы и предлагать улучшения:

Проверь мой скилл presentation-style и предложи, как его улучшить

---

Skill — это только начало. Что дальше?

Скилл научил Claude как оформлять презентацию. Но в Claude Code есть и другие сущности, которые решают другие задачи. Вот как они работают вместе — на том же примере с презентацией:

---

Skill vs CLAUDE.md

И скилл, и CLAUDE.md хранят инструкции для Claude. Разница — когда они загружаются.

CLAUDE.md загружается всегда, при каждом запуске. Сюда пишут то, что Claude должен помнить постоянно, например, "все документы на русском".

Skill загружается только когда нужен. Если вы попросили сделать презентацию — подгрузится скилл про презентации. Попросили написать письмо — подгрузится другой.

Простое правило: если Claude должен знать это всегда — пишите в CLAUDE.md. Если только для конкретной задачи — делайте скилл.

Вместе: в CLAUDE.md пишете "следуй нашим правилам оформления документов", а сами правила храните в скилле. CLAUDE.md задаёт направление, скилл хранит детали.

---

Skill vs Agent

Скилл — это знания или последовательность шагов. Агент — это отдельный работник.

Скилл — это шпаргалка, которую Claude держит перед глазами, пока работает с вами. Агент — это помощник, которого Claude отправляет сделать отдельную задачу и вернуться с результатом. Агент работает в своём отдельном контексте — он не видит ваш диалог.

Пример: вам нужна презентация с данными из разных источников. Вы можете запустить одного агента на сбор метрик продаж, другого — на анализ отзывов. Каждый работает параллельно в своем контексте. Когда агенты вернутся с данными — Claude соберёт всё в презентацию, используя скилл с правилами оформления.

Скиллы и агенты можно комбинировать:

1. Агент загружает скиллы. В настройках агента указываете поле skills: — и агент при запуске получает знания из этих скиллов.

Файл агента .claude/agents/presentation-maker.md:

---
name: presentation-maker
description: Готовит презентации по правилам компании
skills:
  - presentation-style
---

Ты готовишь презентации. Используй правила оформления из загруженного скилла.

Теперь когда Claude запустит этого агента — тот уже знает ваши правила оформления, хотя работает в отдельном контексте.

2. Скилл вызывает агентов. В инструкциях скилла описываете процесс, где Claude запускает агентов для параллельной работы.

Файл скилла .claude/skills/create-presentation/SKILL.md:

---
name: create-presentation
description: Полный цикл создания презентации с данными
---

Создай презентацию

Процесс:
1. Запусти агента для сбора данных из таблиц и отчётов
2. Запусти агента для подготовки графиков и визуализаций
3. Собери результаты и оформи презентацию по правилам из скилла presentation-style

Вызываете /create-presentation итоги Q4 — и Claude сам распределяет работу между агентами.

---

Skill vs MCP

MCP подключает Claude к внешним сервисам — Google Sheets, Slack, базы данных. Без MCP Claude просто не может туда достучаться.

Скилл учит Claude, как пользоваться этими сервисами правильно.

Пример: MCP для Google Sheets даёт Claude возможность читать таблицы. А скилл объясняет, какие именно таблицы брать, как форматировать данные и куда их вставлять в презентацию.

---
name: quarterly-report
description: Сбор данных для квартального отчёта из Google Sheets
---

Для подготовки квартального отчёта:

1. Открой таблицу "Метрики продаж" (ID: abc123) — возьми данные из листа "Сводка"
2. Открой таблицу "Обратная связь" (ID: xyz789) — возьми средние оценки из листа "Q4"
3. Оформи данные в презентацию по правилам из скилла presentation-style

MCP даёт доступ к таблицам, а скилл объясняет — какие именно таблицы открывать и что с данными делать.

---

Как это всё работает вместе

Каждая сущность отвечает за своё. В реальном проекте они дополняют друг друга:

• CLAUDE.md задаёт общие правила: "документы на русском"
• Skill хранит инструкции для конкретной задачи: как оформлять презентацию
• MCP подключает внешние сервисы: Google Sheets с данными, Google Slides для готовой презентации
• Agent берёт на себя часть работы: один собирает данные для презентации, другой анализирует — каждый в своём контексте

---

Частые проблемы

Скилл не появляется при /

Перезапустите Claude Code: /exit → claude. Скиллы загружаются при старте.

Claude игнорирует мой скилл

• Проверьте путь: файл должен быть именно SKILL.md (заглавными) внутри папки .claude/skills/имя-скилла/
• Проверьте YAML-синтаксис frontmatter: пробелы, не табы; двоеточие и пробел после ключа; --- на отдельных строках
• Убедитесь, что description чётко описывает, когда применять скилл

Ошибка в YAML frontmatter

• Используйте пробелы, не табы
• После двоеточия всегда ставьте пробел: name: мой-скилл (правильно), name:мой-скилл (неправильно)
• Если в значении есть двоеточие — оберните в кавычки: description: "Скилл: генерация презентаций"

---

Готово!

Теперь вы знаете, как создавать скиллы и чем они отличаются от других сущностей Claude Code.

Полезные ссылки:

• Документация по скиллам: code.claude.com/docs/en/skills
• Полный гайд по созданию скиллов от Anthropic: The Complete Guide to Building Skills for Claude
• Официальные скиллы от Anthropic: github.com/anthropics/skills
• Каталог скиллов: skills.sh