
Как установить скилл в Claude Code, claude.ai и других ИИ-агентах
В Claude Code скилл ставят папкой со SKILL.md в ~/.claude/skills/ или плагином, в claude.ai загружают ZIP в Customize > Skills. Ниже команды для Codex, Cursor, VS Code, Gemini CLI и ещё 6 агентов.
папку скилла с GitHub: git sparse-checkout или Download ZIP
папка в ~/.claude/skills/ или /plugin install
ZIP с папкой: Customize > Skills > Upload a skill
.agents/skills/ или установщик агента
/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/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.
~/.agents/skills/
.agents/skills/ от текущей папки до корня репозитория
$skill-installer linear; установщик скачает скилл и из другого репозитория
~/.cursor/skills/, ~/.agents/skills/
.cursor/skills/, .agents/skills/, также .claude/skills/
из GitHub только плагином: Customize > From GitHub Repository
~/.copilot/skills/, ~/.agents/skills/, ~/.claude/skills/
.github/skills/, .agents/skills/, .claude/skills/
gh skill install OWNER/REPOSITORY SKILL, нужен GitHub CLI 2.90.0+
~/.gemini/skills/, ~/.agents/skills/
.gemini/skills/, .agents/skills/
gemini skills install <git-url> --consent
~/.gemini/config/skills/
.agents/skills/
agy plugin install https://github.com/<owner>/<repo>
~/.config/opencode/skills/, ~/.claude/skills/, ~/.agents/skills/
.opencode/skills/, .claude/skills/, .agents/skills/
скопировать папку; доп. папки и HTTP-каталоги — массив skills в opencode.json
~/.hermes/skills/
.hermes/skills/, .agents/skills/ после hermes skills trust
hermes skills install openai/skills/k8s
~/.kilo/skills/, ~/.agents/skills/
.kilo/skills/, .agents/skills/
скопировать папку; удалённые каталоги — skills.urls в kilo.jsonc
~/.agents/skills/
.agents/skills/, также .goose/skills/ и .claude/skills/
скопировать папку, проверить командой goose skills list
~/.qwen/skills/, ~/.agents/skills/
.qwen/skills/, .agents/skills/
скопировать папку, открыть панель командой /skills
Почему скилл не срабатывает
Сначала проверьте description и то, видит ли агент скилл. Затем имя папки, путь к SKILL.md и frontmatter.
Claude выбирает скилл по полю description. Впишите туда слова, которыми вы ставите задачу, и попробуйте сформулировать просьбу ближе к описанию. Помогает и прямое указание: «Use my brand guidelines skill to create a presentation».
В claude.ai проверьте тумблер скилла в Customize > Skills. В Claude Code спросите «What skills are available?» или вызовите скилл по имени. Если команда не находится, проверьте имя на невидимые символы, двойные пробелы и знаки < и >.
/skillsРасхождение имени папки и имени скилла claude.ai называет среди частых причин ошибки загрузки. Переименуйте папку или поправьте name, чтобы они совпали буква в букву.
Claude Code ждёт файл по пути ~/.claude/skills/<имя>/SKILL.md. В ZIP для claude.ai в корне лежит папка скилла, SKILL.md внутри неё; архив без файла скилла claude.ai не примет.
С битым 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Личные скиллы из ~/.claude/skills/ в Cowork и облачные сессии не попадают. Там работают скиллы, включённые в аккаунте claude.ai, или скиллы из .claude/skills/ репозитория.
Частые вопросы
Как установить скилл в Claude?
Как добавить скилл в Claude через claude.ai?
Как установить skill в Claude Code?
Где скачать скиллы для Claude?
Что такое Claude AI skills?
Источники: 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