# Skills Claude Code: как писать, ставить и проверять

URL: https://agentvera.dev/ru/blog/claude-code-skills/ · Опубликовано: 2026-10-24

Skills Claude Code: формат SKILL.md, папки проекта и пользователя, когда Claude загружает skill и как находить, проверять и устанавливать skills из галереи.

**Коротко:**

- Skill Claude Code — это папка с файлом SKILL.md: имя и описание во frontmatter, затем инструкции. Claude читает описания и загружает полный skill, только когда он нужен.
- Skills проекта лежат в .claude/skills и передаются через git; личные skills лежат в ~/.claude/skills. Skill можно вызвать и напрямую как /skill-name.
- Skill — это инструкции, которым следует ваш агент, поэтому скачанный skill нужно считать кодом. Галерея skills AgentVera проверяет каждый skill на опасные команды, секреты и prompt injection до установки.

**Skills Claude Code — это папки с файлом `SKILL.md`, которые учат Claude повторяющейся задаче, например ревью PR или выпуску релиза, и Claude загружает skill, только когда он нужен вашему запросу.** Поэтому skills — подходящее место для инструкций, важных для одних задач, но не для каждой сессии. Есть нюанс: skill — это инструкции, которым последует ваш агент, поэтому skill из интернета заслуживает такой же осторожности, как скрипт из интернета.

В статье: формат skill, где они лежат, как Claude их выбирает, как написать хороший skill и как находить и устанавливать чужие skills, не отдавая агенту ничего опасного.

## Что такое skill Claude Code

Skill — это папка. Единственный обязательный файл — `SKILL.md`:

```markdown
---
name: release-notes
description: Use when the user asks for release notes or a changelog entry for a version.
---

1. Run `git log --oneline <last-tag>..HEAD`.
2. Group the commits into Features, Fixes and Other.
3. Write one plain sentence per change, for users, not developers.
4. Ask before writing to CHANGELOG.md.
```

Во frontmatter лежат `name` и `description`. Тело — инструкция, которой Claude следует после загрузки skill. В папке могут быть также скрипты и справочные файлы, на которые ссылаются инструкции, так что skill может сказать «запусти `scripts/check.sh`» или «прочитай `reference/api.md` для списка endpoint».

## Где живут skills Claude Code

| Расположение | Кому доступно | Типичное применение |
| --- | --- | --- |
| `.claude/skills/<name>/SKILL.md` | Всем, кто работает с репозиторием, через git | Процессы проекта: deploy, миграции, релиз |
| `~/.claude/skills/<name>/SKILL.md` | Вам, в каждом проекте | Личные привычки: ваш чек-лист ревью, стиль коммитов |

Имя папки становится командой, так что `.claude/skills/release-notes/SKILL.md` можно запустить и как `/release-notes`. Введите `/skills` в сессии, чтобы увидеть список skills, которые видит Claude. Об остальных slash-командах см. [шпаргалку по командам Claude Code](/ru/blog/claude-code-commands-cheat-sheet/ "Шпаргалка по командам Claude Code").

## Как Claude решает использовать skill

В начале сессии Claude видит описания skills, а не их полное содержимое. Когда ваш запрос совпадает с описанием, он загружает этот skill. Отсюда два вывода:

- **Маршрутизацию делает описание.** «Skill для release notes» — слабое описание. «Use when the user asks for release notes or a changelog entry for a version» говорит Claude, когда к нему обращаться.
- **Skills сохраняют базовый контекст небольшим.** Каждую сессию загружаются только описания, так что перенос специфичных для задач инструкций из `CLAUDE.md` в skills облегчает каждый ход. Подробнее в статье [контекстное окно Claude Code](/ru/blog/claude-code-context-window/ "Контекстное окно Claude Code").

## Skills, CLAUDE.md, субагенты и MCP

Эти четыре вещи пересекаются, поэтому полезно знать, какая подходит.

| Инструмент | Что загружается | Лучше всего для |
| --- | --- | --- |
| `CLAUDE.md` | Каждую сессию, весь файл | Правил, которые действуют всегда |
| Skill | Описание всегда, тело по требованию | Процесса, который вы время от времени повторяете |
| Субагент | При делегировании, в собственном контексте | Тяжёлой работы, детали которой вам не нужны обратно |
| Сервер MCP | Определения инструментов каждую сессию | Доступа к внешним системам или данным |

Если вы дважды в неделю вставляете в промпты один и тот же абзац, это должен быть skill. Если агенту нужно обращаться к базе данных или API, это сервер MCP ([что такое сервер MCP](/ru/blog/what-is-mcp-server/ "Что такое сервер MCP?")).

## Как написать хороший skill

1. **Начните с задачи, которую уже повторяете.** Запишите шаги, которые вы набираете сегодня.
2. **Пишите описание как триггер.** Начните с «Use when…» и назовите слова, которые сказал бы пользователь.
3. **Держите тело коротким и упорядоченным.** Нумерованные шаги лучше абзацев.
4. **Длинный материал выносите в файлы.** Справочная таблица или скрипт лежат рядом с `SKILL.md`, а тело говорит, когда их читать или запускать.
5. **Пишите, чего делать не нужно.** «Ask before writing to CHANGELOG.md» предотвращает сюрприз, который иначе пришлось бы исправлять вручную.
6. **Проверьте в новой сессии.** Попросите задачу своими словами и убедитесь, что Claude выбирает skill без подсказки.

## Риск общих skills

Обмен skills делает их полезными и рискованными. Skill может велеть агенту выполнить shell-команду, прочитать файл за пределами проекта или отправить что-то по URL. Если ваш агент работает с широкими правами, вредоносный или небрежный skill работает с ними тоже. На что смотреть перед установкой:

- Разрушительные или привилегированные команды (`rm -rf`, `sudo`)
- Чтение секретов, например файлов `.env` или SSH-ключей
- Отправка данных на неизвестный вам хост
- Схемы «скачать и запустить», например передача `curl` в shell
- Обфусцированный код или скрытые символы Unicode
- Prompt injection: текст, пытающийся переопределить ваши инструкции

Статья [безопасность ИИ-агентов для кода](/ru/blog/ai-coding-agent-security/ "Безопасность ИИ-агентов для кода") подробнее рассказывает о разрешениях и песочницах.

## Управление skills в AgentVera

[Галерея skills](/ru/features/skill-gallery/ "Галерея skills") AgentVera находится на странице Details проекта, **Automation → Skills**. В ней три представления: **Local**, **Discover** и **My published**.

**Local** перечисляет skills на вашем компьютере для обоих агентов, использующих папки skills:

| Агент | Папка проекта | Личная папка |
| --- | --- | --- |
| Claude Code | `.claude/skills` | `~/.claude/skills` |
| Codex | `.agents/skills` | `~/.codex/skills` |

Отсюда можно:

- Создать skill через **New skill**: выберите **Agent** (Claude Code или Codex), **Scope** (**This project** или **All projects**), **Name** (строчные буквы, цифры и дефисы) и **When should it be used?**, что станет описанием. **Create and edit** откроет новый `SKILL.md`.
- Отключить skill, не удаляя его. Переключатель переносит папку туда, где CLI её не сканируют.
- Просмотреть или отредактировать `SKILL.md`, скопировать skill другому агенту или в другую область либо удалить его, и тогда папка отправится в Корзину.

## Как безопасно находить и устанавливать skills

**Discover** показывает skills вашей организации и публичную галерею. Ищите, выбирайте одну из 10 категорий (coding, testing, code review, DevOps, data, docs, design, security, productivity, other), фильтруйте по агенту и сортируйте по **Popular** или **New**. Та же галерея есть в вебе на app.agentvera.dev/skills.

В карточке каждого skill есть вкладки **Files**, **Security** и **Versions**. Вкладка Security показывает **Server scan**. Проверка ищет разрушительные или привилегированные команды, чтение секретов, встроенные ключи, отправку данных наружу, «скачать и запустить», обфусцированный код, prompt injection, скрытый Unicode, «сырые» IP-адреса и внешние хосты. Результаты идут от чистого через info, low, medium и high risk до critical.

Установка в два шага:

1. **Download and scan.** AgentVera скачивает файлы, проверяет их SHA-256 и ещё раз сканирует на вашем компьютере.
2. **Install.** Скрипты записываются как обычные файлы и не становятся исполняемыми.

Агенты увидят skill в следующей сессии. Когда публикуется новая версия, рядом с установленным skill появляется кнопка обновления. Skills из галереи устанавливаются только для поддерживаемых ими агентов: Claude Code и Codex.

Публичные skills проходят проверку безопасности и модерацию, но всё равно просмотрите результаты и файлы. Сканер ловит шаблоны; что должен и чего не должен делать ваш проект, знаете вы.

## Публикация собственных skills

С тарифом Pro или Team и аккаунтом AgentVera **Share** публикует локальный skill. Вы задаёте название, краткое описание от 20 до 300 символов, до 6 тегов, категорию и версию вроде `1.0.0`, с changelog для каждой версии. Skill ограничен 50 текстовыми файлами, 256 КБ на файл и 1 МБ в сумме.

- **Только организация:** сразу виден вашей организации, если проверка не находит ничего уровня high или critical; иначе публикация отклоняется.
- **Публично:** ждёт одобрения модератора, замечания уровня critical не принимаются. Следите за этим в **My published**.

## Skills и расход токенов

Каждый skill добавляет своё описание в базовый контекст. Несколько штук — нормально; десятки личных skills складываются на каждом ходу. Профиль контекста Lean в AgentVera не загружает skills уровня пользователя, и это одна из причин, почему первый запрос меньше ([измерения здесь](/ru/blog/claude-code-token-usage/ "Сократите расход токенов Claude Code на 61%")). Держите skills проекта в репозитории и удаляйте личные, которыми больше не пользуетесь.

## Итоги

Skills Claude Code превращают повторяющиеся промпты в папки, которые Claude загружает по требованию: `SKILL.md` с чётким описанием «use when», короткими упорядоченными шагами и нужными скриптами, в `.claude/skills` для проекта или `~/.claude/skills` для вас. Чужие skills стоят того, только если вы их проверяете. AgentVera показывает skills Claude Code и Codex в одном месте, сканирует skills галереи на сервере и ещё раз на вашем компьютере перед установкой и позволяет пользователям Pro и Team публиковать свои. [Скачайте AgentVera](/ru/download/), чтобы управлять своими skills.

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

**Что такое skills Claude Code?** Повторно используемые инструкции, упакованные в папку с файлом SKILL.md. Во frontmatter есть имя и описание; тело говорит, что делать. В папке также могут лежать скрипты и справочные файлы, на которые ссылается skill.

**Куда положить skill Claude Code?** В .claude/skills/<name>/SKILL.md для проекта, чтобы он был у всех в репозитории, или в ~/.claude/skills/<name>/SKILL.md для себя во всех проектах.

**Как Claude решает, что использовать skill?** Он видит описания skills и загружает полный skill, когда ваш запрос совпадает с одним из них. Поэтому описание должно говорить, когда использовать skill, а не только что это такое. Вы также можете запустить его сами через /skill-name.

**Безопасно ли ставить skills из интернета?** По умолчанию нет. Skill может велеть вашему агенту выполнять команды, читать файлы или отправлять данные наружу. Сначала прочитайте его. AgentVera проверяет skills галереи на разрушительные команды, чтение секретов, исходящие данные, «скачать и запустить» и prompt injection и повторно проверяет на вашем компьютере перед установкой.

**Платная ли галерея skills AgentVera?** Управление, просмотр и установка skills входят в бесплатный тариф. Для публикации собственных skills в галерее нужны тариф Pro или Team и аккаунт AgentVera.

---

**Об AgentVera.** AgentVera — настольное приложение для macOS, Windows и Linux от Solviera Teknoloji. Оно запускает 18 ИИ-агентов для программирования (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) рядом, по проектам, в настоящих терминалах с собственными установками CLI и входами пользователя. В бесплатном тарифе количество агентов не ограничено. Скачать: https://agentvera.dev/ru/download/ · Цены: https://agentvera.dev/ru/pricing/