# Как использовать скиллы в Claude Code

> Скилл — это инструкция для Claude Code, как делать определённую работу: папка с файлом SKILL.md. Агент сам подгружает скилл, когда задача подходит под его описание, или ты вызываешь его командой `/имя`. Свой скилл можно сделать одним запросом к агенту.

Автор: Данил Капнин. Опубликовано 2026-10-26. Оригинал: https://kapnin.tech/guides/kak-ispolzovat-skilly-v-claude-code/

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

Представь, что ты каждый раз объясняешь агенту одно и то же: «пост для Telegram пиши так-то, длина такая-то, без эмодзи, в конце ссылка». Скилл — это такое объяснение, записанное один раз. Дальше достаточно сказать «напиши пост про новый гайд», и агент сам найдёт нужную инструкцию.

Внутри скилла лежит файл SKILL.md. В его начале стоят название и описание: когда этот скилл нужен. Ниже — сама инструкция: шаги, правила, примеры. Рядом можно положить шаблоны, примеры удачных работ и вспомогательные файлы.

## Чем скилл отличается от CLAUDE.md и MCP

| Что | Когда читается | Для чего |
|---|---|---|
| [CLAUDE.md](https://kapnin.tech/guides/fayl-pravil-dlya-agenta-claude-md-agents-md/) | Всегда, в каждом сообщении | Общие правила проекта: стек, запреты, как проверять |
| Скилл | Только когда задача подходит или ты вызвал его | Как делать конкретную работу: пост, обложку, релиз, отчёт |
| [MCP-сервер](https://kapnin.tech/guides/chto-takoe-mcp-i-zachem-on-nuzhen/) | Когда нужен инструмент | Доступ к программам: Figma, Notion, GitHub, Vercel |

Пока скилл не нужен, агент держит в памяти только его короткое описание. Поэтому скиллов может быть много, и лимит на них почти не тратится, в отличие от длинного CLAUDE.md. Подробнее в гайде [как экономить лимиты Claude](https://kapnin.tech/guides/kak-ekonomit-limity-claude/).

## Где лежат скиллы

- **Личные:** в папке `~/.claude/skills/` на твоём компьютере. Работают во всех проектах.
- **Проектные:** в папке `.claude/skills/` внутри проекта. Сохраняются в git вместе с проектом и достаются всем, кто с ним работает.
- **Из плагинов:** ставятся вместе с плагином и вызываются как `/плагин:скилл`.
- **Встроенные:** идут с Claude Code, например проверка кода или диагностика настроек.

Список всех доступных скиллов открывается командой `/skills`.

## Как пользоваться готовым скиллом

1. Набери `/` в поле запроса: в подсказках будут команды и скиллы.
2. Выбери нужный или просто опиши задачу словами. Если она подходит под описание скилла, агент подгрузит его сам.
3. Чтобы проверить, какие скиллы сейчас загружены, набери `/context`.

## Как сделать свой скилл

Писать файл руками не нужно. Хороший кандидат на скилл — работа, которую ты делаешь хотя бы раз в неделю и каждый раз объясняешь заново. Отдай агенту такой запрос, заменив пример на свою задачу:

```text
Сделай мне личный скилл для Claude Code «telegram-post»: он пишет пост для моего Telegram-канала по ссылке на гайд.

Правила поста: до 800 знаков, первая строка — польза для читателя, без эмодзи и хэштегов, в конце ссылка на гайд. Вот два моих удачных поста как пример стиля: [вставь посты].

Скилл положи в ~/.claude/skills/telegram-post/. В описании напиши, когда его использовать, теми словами, которыми я буду просить: «пост в телеграм», «анонс гайда». Инструкцию держи короткой, примеры вынеси в отдельный файл рядом.

Когда сделаешь, покажи мне текст SKILL.md и проверь скилл на гайде https://kapnin.tech/guides/kak-ekonomit-limity-claude/
```

**Совет.** Главное в скилле — описание. Если в нём нет слов, которыми ты обычно просишь, агент не поймёт, что скилл нужен. Пиши описание как список ситуаций: «когда просят пост в Telegram, анонс, текст для канала».

## Как проверить, что скилл работает

1. Начни новую беседу командой `/clear`.
2. Попроси задачу своими обычными словами, не называя скилл.
3. Посмотри, подхватил ли агент скилл: он пишет об этом в ходе работы, а результат следует твоим правилам.
4. Не подхватил — вызови скилл явно через `/telegram-post` и попроси агента дописать в описание твою формулировку.

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

## Если что-то пошло не так

| Что видишь | Что делать |
|---|---|
| Скилла нет в `/skills` | Проверь, что файл называется ровно SKILL.md и лежит в своей папке внутри skills. Команда `/doctor` покажет проблемы |
| Агент не использует скилл сам | Допиши в описание слова, которыми ты формулируешь задачу |
| Скилл срабатывает не к месту | Сузь описание или запрети автозапуск, чтобы он работал только по команде |
| Скилл делает не так, как надо | Покажи агенту результат и попроси поправить инструкцию в SKILL.md, а не только этот текст |

## Частые вопросы

### Скиллы работают в обычном чате Claude?

Да, скиллы можно включить и на claude.ai. Включённые там скиллы доступны в Claude Code, если ты вошёл тем же аккаунтом. А личные скиллы из папки на компьютере работают только в Claude Code.

### Чем скилл отличается от slash-команды?

Сейчас это одно и то же: старые команды из `.claude/commands/` по-прежнему работают, но скилл умеет больше — у него есть папка для файлов, и агент может подгрузить его сам.

### Где взять готовые скиллы?

Часть встроена в Claude Code, часть ставится вместе с плагинами. Чужие скиллы перед установкой попроси агента проверить: внутри могут быть команды, которые он выполнит.

### Скиллы тратят лимит?

Почти нет, пока не нужны: в памяти лежит только короткое описание. Полная инструкция загружается, когда скилл используется.