Что такое skills Claude Code?

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

Куда положить skill Claude Code?

В .claude/skills/ /SKILL.md для проекта, чтобы он был у всех в репозитории, или в ~/.claude/skills/ /SKILL.md для себя во всех проектах.

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

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

Безопасно ли ставить skills из интернета?

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

Платная ли галерея skills AgentVera?

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

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

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

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

Что такое skill Claude Code

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

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

Как 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.

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

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

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

Если вы дважды в неделю вставляете в промпты один и тот же абзац, это должен быть skill. Если агенту нужно обращаться к базе данных или API, это сервер MCP (что такое сервер MCP).

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

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

Риск общих skills

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

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

Статья безопасность ИИ-агентов для кода подробнее рассказывает о разрешениях и песочницах.

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

Галерея 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.

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

Download and scan. AgentVera скачивает файлы, проверяет их SHA-256 и ещё раз сканирует на вашем компьютере.
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 уровня пользователя, и это одна из причин, почему первый запрос меньше (измерения здесь). Держите skills проекта в репозитории и удаляйте личные, которыми больше не пользуетесь.

Итоги

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