Как установить скилл в Claude Code, claude.ai и других ИИ-агентах

Проверено 13.11.2026

В Claude Code скилл ставят папкой со SKILL.md в ~/.claude/skills/ или плагином, в claude.ai загружают ZIP в Customize > Skills. Ниже команды для Codex, Cursor, VS Code, Gemini CLI и ещё 6 агентов.

1Скачать

папку скилла с GitHub: git sparse-checkout или Download ZIP

2Claude Code

папка в ~/.claude/skills/ или /plugin install

3claude.ai

ZIP с папкой: Customize > Skills > Upload a skill

4Другие агенты

.agents/skills/ или установщик агента

5Проверка

/skills в Claude Code, тумблер скилла в claude.ai

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

Скилл в Claude Code — папка с файлом SKILL.md. Положите её в ~/.claude/skills/<имя>/, и скилл будет работать во всех ваших проектах на этом компьютере. Папка .claude/skills/<имя>/ внутри репозитория подключает скилл только в этом проекте: закоммитьте её, и скилл получит вся команда.

Имя папки или поле name из SKILL.md становится командой: скилл из папки summarize-changes вызывается как /summarize-changes. Claude включает скилл и сам, когда ваша просьба совпадает с его description. Если скилл с одним именем лежит и в личной папке, и в проекте, сработает личный.

Новые и исправленные скиллы в этих папках Claude Code подхватывает в текущей сессии без перезапуска. Если папку skills создали уже после запуска сессии, выполните /reload-skills. Проверить установку можно командой /skills или вопросом «What skills are available?».

# личный скилл: доступен во всех проектах
mkdir -p ~/.claude/skills
cp -r my-skill ~/.claude/skills/

# скилл проекта: только в этом репозитории
mkdir -p .claude/skills
cp -r my-skill .claude/skills/

# проверка в сессии Claude Code
/skills
Личные
Путь

~/.claude/skills/<имя>/SKILL.md

Где работает

во всех ваших проектах на этом компьютере, кроме Cowork и облачных сессий

Проект
Путь

.claude/skills/<имя>/SKILL.md

Где работает

в сессиях этого репозитория

Плагин
Путь

<плагин>/skills/<имя>/SKILL.md

Где работает

везде, где включён плагин, командой /плагин:имя

Аккаунт claude.ai
Путь

~/.claude/skills/synced/

Где работает

скачивается сам при входе в Claude Code аккаунтом claude.ai

Установка скилла плагином и через npx skills

Готовые наборы скиллов часто распространяют плагинами. Сначала добавьте маркетплейс командой /plugin marketplace add: подойдёт репозиторий GitHub вида owner/repo, git-адрес на любом хостинге, локальная папка или ссылка на marketplace.json. Затем поставьте плагин командой /plugin install <плагин>@<маркетплейс>. В сессии она открывает панель /plugin, где вы выбираете область установки.

Маркетплейс Anthropic claude-plugins-official Claude Code добавляет сам при первом запуске в терминале. Из оболочки, без сессии, плагин ставит claude plugin install: по умолчанию для пользователя, с флагом --scope project для проекта. Такие плагины загружаются при следующем запуске Claude Code или после /reload-plugins.

Установщик npx skills от Vercel копирует скиллы из репозиториев GitHub в папки разных агентов, ему нужен Node.js 22.20 или новее. С флагом -a claude-code скилл ляжет в .claude/skills/ текущего проекта, с флагом -g — в ~/.claude/skills/. Источником может быть owner/repo или ссылка на папку скилла вида github.com/owner/repo/tree/main/skills/<имя>.

# в сессии Claude Code: скиллы Anthropic для документов
/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills

# то же из оболочки, без сессии
claude plugin marketplace add anthropics/skills
claude plugin install document-skills@anthropic-agent-skills

# установщик npx skills: один скилл для Claude Code
npx skills add vercel-labs/agent-skills --skill web-design-guidelines -a claude-code

Как добавить скилл в claude.ai и Claude Desktop

В чате claude.ai скиллы работают на тарифах Free, Pro, Max, Ultra, Team и Enterprise, и им нужно выполнение кода. На личных тарифах включите Code execution and file creation в Settings > Capabilities, в новой раскладке настроек пункт называется Create and edit files. На Team и Enterprise выполнение кода и Skills включает владелец в Organization settings > Plugins & skills, вкладка Policy.

Свой скилл загружается ZIP-архивом: Customize > Skills, кнопка «+», затем + Create skill и Upload a skill. В корне архива лежит папка скилла, в ней SKILL.md. Архив с файлами прямо в корне не подходит, имя папки совпадает с именем скилла. В приложении Claude Desktop скиллами управляют через Customize в боковой панели.

Встроенные скиллы Anthropic для Excel, Word, PowerPoint и PDF доступны всем: при включённом выполнении кода Claude берёт их сам, например на просьбу сделать презентацию. Устанавливать их не нужно.

Во frontmatter для claude.ai допустимы только 6 полей стандарта: name, description, license, compatibility, metadata и allowed-tools. С полем Claude Code вроде argument-hint или when_to_use загрузка прерывается ошибкой «Unexpected key(s) in SKILL.md frontmatter». Уберите лишние поля из копии для загрузки.

Скиллы из claude.ai не попадают в Claude API: туда их загружают отдельно, через Skills API. В Claude Code 2.1.273 и новее, если вы вошли аккаунтом claude.ai, включённые там скиллы скачиваются в ~/.claude/skills/synced/ при старте сессии и проверяются на изменения примерно раз в 10 минут. В меню /skills они собраны под заголовком claude.ai sync. Синхронизация идёт в одну сторону: правки в папке synced на claude.ai не уходят, и следующая синхронизация может их перезаписать. При входе по API-ключу или через Amazon Bedrock скиллы не синхронизируются.

Включить выполнение кода
Где в интерфейсе

Settings›Capabilities›Code execution and file creation

Загрузить свой скилл
Где в интерфейсе

Customize›Skills›+›+ Create skill›Upload a skill

Включить или выключить скилл
Где в интерфейсе

Customize›Skills›тумблер у скилла

Скачать копию своего скилла
Где в интерфейсе

Customize›Skills›скилл›...›Download

Удалить скилл
Где в интерфейсе

Customize›Skills›скилл›...›Delete

Как скачать скилл с GitHub

Скилл в репозитории — папка со SKILL.md, обычно внутри каталога skills/. Весь репозиторий скачивать не обязательно. Команда git clone с флагами --filter=blob:none и --sparse берёт только файлы из корня, нужную папку добавляет git sparse-checkout set.

Без git репозиторий скачивают архивом: на странице репозитория нажмите Code, затем Download ZIP, распакуйте и возьмите папку нужного скилла. Ещё короче установщики агентов: npx skills add, gh skill install, gemini skills install и hermes skills install сами кладут скилл в нужную папку.

Для claude.ai заархивируйте саму папку скилла, чтобы она лежала в корне ZIP. Если SKILL.md пишете сами, генератор на странице /mcp/skills/skill-md/ соберёт ZIP для claude.ai прямо в браузере.

Ставьте скиллы из источников, которым доверяете: в скилле бывают скрипты и указания обращаться к внешним адресам. Перед установкой прочитайте его файлы. Команда gh skill preview показывает SKILL.md и дерево файлов без установки.

# скачать одну папку из репозитория anthropics/skills
git clone --depth 1 --filter=blob:none --sparse https://github.com/anthropics/skills.git
cd skills
git sparse-checkout set skills/frontend-design

# положить скилл в Claude Code
cp -r skills/frontend-design ~/.claude/skills/

Как установить скилл в Codex, Cursor, VS Code и других агентах

Большинство агентов читает общую папку .agents/skills/ в проекте и ~/.agents/skills/ в домашней папке: положите скилл туда, и им пользуются сразу несколько агентов. Claude Code ищет скиллы в своих папках .claude/skills/ и ~/.claude/skills/.

Установщик npx skills знает папки почти 80 агентов: вместо -a claude-code укажите -a codex, -a cursor, -a gemini-cli, -a opencode или другое имя агента. Codex подхватывает новые скиллы сам, если скилл не появился, перезапустите Codex.

Codex
Личные скиллы

~/.agents/skills/

Скиллы проекта

.agents/skills/ от текущей папки до корня репозитория

Как поставить

$skill-installer linear; установщик скачает скилл и из другого репозитория

Cursor
Личные скиллы

~/.cursor/skills/, ~/.agents/skills/

Скиллы проекта

.cursor/skills/, .agents/skills/, также .claude/skills/

Как поставить

из GitHub только плагином: Customize > From GitHub Repository

VS Code и Copilot
Личные скиллы

~/.copilot/skills/, ~/.agents/skills/, ~/.claude/skills/

Скиллы проекта

.github/skills/, .agents/skills/, .claude/skills/

Как поставить

gh skill install OWNER/REPOSITORY SKILL, нужен GitHub CLI 2.90.0+

Gemini CLI
Личные скиллы

~/.gemini/skills/, ~/.agents/skills/

Скиллы проекта

.gemini/skills/, .agents/skills/

Как поставить

gemini skills install <git-url> --consent

Antigravity
Личные скиллы

~/.gemini/config/skills/

Скиллы проекта

.agents/skills/

Как поставить

agy plugin install https://github.com/<owner>/<repo>

OpenCode
Личные скиллы

~/.config/opencode/skills/, ~/.claude/skills/, ~/.agents/skills/

Скиллы проекта

.opencode/skills/, .claude/skills/, .agents/skills/

Как поставить

скопировать папку; доп. папки и HTTP-каталоги — массив skills в opencode.json

Hermes Agent
Личные скиллы

~/.hermes/skills/

Скиллы проекта

.hermes/skills/, .agents/skills/ после hermes skills trust

Как поставить

hermes skills install openai/skills/k8s

Kilo Code
Личные скиллы

~/.kilo/skills/, ~/.agents/skills/

Скиллы проекта

.kilo/skills/, .agents/skills/

Как поставить

скопировать папку; удалённые каталоги — skills.urls в kilo.jsonc

Goose
Личные скиллы

~/.agents/skills/

Скиллы проекта

.agents/skills/, также .goose/skills/ и .claude/skills/

Как поставить

скопировать папку, проверить командой goose skills list

Qwen Code
Личные скиллы

~/.qwen/skills/, ~/.agents/skills/

Скиллы проекта

.qwen/skills/, .agents/skills/

Как поставить

скопировать папку, открыть панель командой /skills

Почему скилл не срабатывает

Сначала проверьте description и то, видит ли агент скилл. Затем имя папки, путь к SKILL.md и frontmatter.

В description нет нужных слов

Claude выбирает скилл по полю description. Впишите туда слова, которыми вы ставите задачу, и попробуйте сформулировать просьбу ближе к описанию. Помогает и прямое указание: «Use my brand guidelines skill to create a presentation».

Скилл выключен или не загрузился

В claude.ai проверьте тумблер скилла в Customize > Skills. В Claude Code спросите «What skills are available?» или вызовите скилл по имени. Если команда не находится, проверьте имя на невидимые символы, двойные пробелы и знаки < и >.

/skills
Имя папки не совпадает с name

Расхождение имени папки и имени скилла claude.ai называет среди частых причин ошибки загрузки. Переименуйте папку или поправьте name, чтобы они совпали буква в букву.

Файл лежит не там

Claude Code ждёт файл по пути ~/.claude/skills/<имя>/SKILL.md. В ZIP для claude.ai в корне лежит папка скилла, SKILL.md внутри неё; архив без файла скилла claude.ai не примет.

Ошибка в frontmatter

С битым YAML Claude Code загружает скилл без полей: команда /имя работает, по description Claude скилл уже не находит. Ошибку разбора покажет запуск с --debug или проверка claude plugin validate в Claude Code 2.1.233 и новее.

claude plugin validate ~/.claude/skills
Слишком много скиллов

Список имён и описаний занимает до 1 % окна контекста. Когда скиллов много, описания редко вызываемых выпадают, и Claude теряет слова для выбора. Оценку покажет /doctor, бюджет поднимает настройка skillListingBudgetFraction. Главный сценарий ставьте в начало description: вместе с when_to_use оно обрезается на 1 536 знаках.

/doctor
Папку создали после запуска

Папку skills, которой не было на старте сессии, Claude Code не отслеживает. После её создания выполните /reload-skills и повторяйте команду после каждой правки в этой папке.

/reload-skills
Облачная сессия или Cowork

Личные скиллы из ~/.claude/skills/ в Cowork и облачные сессии не попадают. Там работают скиллы, включённые в аккаунте claude.ai, или скиллы из .claude/skills/ репозитория.

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

Как установить скилл в Claude?
В Claude Code положите папку скилла со SKILL.md в ~/.claude/skills/ или поставьте плагин командой /plugin install <плагин>@<маркетплейс>. В claude.ai и Claude Desktop загрузите ZIP с папкой скилла: Customize > Skills, «+», + Create skill, Upload a skill. Перед этим включите выполнение кода в Settings > Capabilities.
Как добавить скилл в Claude через claude.ai?
Заархивируйте папку скилла в ZIP так, чтобы она лежала в корне архива. Откройте Customize > Skills, нажмите «+», затем + Create skill и Upload a skill. Во frontmatter оставьте только name, description, license, compatibility, metadata и allowed-tools, иначе загрузка прервётся ошибкой Unexpected key(s).
Как установить skill в Claude Code?
Скопируйте папку скилла в ~/.claude/skills/ для всех проектов или в .claude/skills/ репозитория для одного проекта. Claude Code подхватит скилл без перезапуска, вызвать его можно командой /имя-скилла. Скилл из чужого репозитория ставит команда npx skills add owner/repo -a claude-code.
Где скачать скиллы для Claude?
Скиллы Anthropic лежат в репозитории anthropics/skills на GitHub. В Claude Code его подключают командой /plugin marketplace add anthropics/skills, отдельную папку скачивают через git sparse-checkout или кнопкой Download ZIP. Скиллы с командами установки для разных агентов собраны в каталоге /mcp/skills/.
Что такое Claude AI skills?
Скилл — папка с файлом SKILL.md: в нём имя, описание и инструкции, рядом могут лежать скрипты и шаблоны. Claude подгружает скилл, когда задача совпадает с описанием. В claude.ai встроены скиллы для Excel, Word, PowerPoint и PDF, свои загружаются ZIP-архивом.

Источники: https://code.claude.com/docs/en/skills, https://code.claude.com/docs/en/discover-plugins, https://support.claude.com/en/articles/12512180-using-skills, https://support.claude.com/en/articles/12512198-how-to-creat, https://platform.claude.com/docs/en/agents-and-tools/agent-s, anthropics/skills, vercel-labs/skills, https://learn.chatgpt.com/docs/build-skills