claude code skills: что такое skills, где они лежат и как написать свой

claude code skills — это папки с файлом SKILL.md, в которых лежит инструкция для агента: как делать конкретную задачу, что проверить, какие скрипты запустить. claude видит только название и описание каждого skill, а полный текст подгружает, когда задача подходит под описание или когда ты сам вызываешь его командой /имя. ниже — где они лежат, как написать свой по шагам, где брать готовые и как не поставить вредный. всё сверено с документацией anthropic на 14 октября 2026.

что такое claude code skills простыми словами

skill — это сохранённый навык агента. вместо того чтобы в десятый раз вставлять в чат один и тот же порядок действий («собери проект, прогони линтер, проверь мета-теги»), ты один раз кладёшь его в папку, и claude code берёт его сам, когда он нужен. в рунете их ещё называют навыками или пишут «скилы для клод код» — это одно и то же.

минимальный skill — одна папка и один файл SKILL.md. в начале файла идёт блок между строками --- (frontmatter) с именем и описанием, дальше обычный markdown с инструкцией. рядом можно положить справочники, примеры и скрипты. структура из документации:

my-skill/
├── SKILL.md        (обязательный: обзор и навигация)
├── reference.md    (подробности, читается по необходимости)
├── examples.md     (примеры)
└── scripts/
    └── helper.py   (скрипт: выполняется, а не читается)

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

вызвать skill можно двумя способами: claude сам решает, что задача подходит под описание, или ты пишешь /имя-skill в начале сообщения. в claude code уже есть встроенные skills — /code-review, /simplify, /debug, /batch, /loop и другие, они работают так же, как твои. список всех доступных показывает команда /skills. если ты только начинаешь, сначала прочитай, как пользоваться claude code: skills — это следующий шаг.

где лежат skills: личные, проектные и из плагинов

место папки решает, где skill работает. по документации claude code:

если skill с одним именем лежит в нескольких местах, побеждает корпоративный, потом личный, потом проектный. у skills из плагинов имя с префиксом плагина, поэтому они ни с чем не конфликтуют. правки в SKILL.md подхватываются прямо в текущей сессии без перезапуска. если посреди сессии ты создал папку skills там, где её раньше не было, выполни /reload-skills.

практическое правило: то, что нужно тебе везде (свой формат коммитов, проверка перед выкладкой), клади в личные. то, что касается одного проекта (как деплоить именно этот сайт), — в проектные и в git, тогда skill будет у всех, кто работает с репозиторием.

как написать свой skill: пошагово

соберём skill, который проверяет мета-теги страниц перед выкладкой сайта. понадобится установленный claude code — если его ещё нет, вот как установить claude code на windows и mac.

шаг 1. создай папку

mkdir -p ~/.claude/skills/seo-meta

имя папки станет командой /seo-meta. в имени — только строчная латиница, цифры и дефисы.

шаг 2. напиши SKILL.md

---
name: seo-meta
description: Проверяет title и meta description html-страниц сайта. Используй, когда пользователь просит проверить мета-теги, сниппет или seo страниц перед выкладкой.
---

# проверка мета-тегов

1. найди в проекте все html-страницы и шаблоны страниц.
2. для каждой выпиши title и meta description.
3. отметь проблемы: тег пустой или его нет; одинаковый title на разных страницах; description повторяет title; главной фразы страницы нет в title.
4. выведи таблицу: страница, title, description, что не так.
5. ничего не меняй в файлах, пока пользователь не скажет «чини».

блок frontmatter обязан начинаться с первой строки файла. самое важное поле — description: по нему claude решает, брать skill или нет. в нём должно быть и что делает skill, и когда его использовать, причём теми словами, какими ты обычно ставишь задачу.

шаг 3. проверь в деле

открой claude code в папке сайта и напиши обычным языком: «проверь мета-теги перед выкладкой». claude сопоставит запрос с описанием и сам подгрузит skill. второй способ — набрать /seo-meta. если skill не срабатывает сам, почти всегда виновато описание: оно слишком общее или пересекается с другим skill.

шаг 4. добавь аргументы и живые данные

всё, что ты напишешь после команды, попадает в skill через $ARGUMENTS: набираешь /seo-meta blog, а в тексте skill пишешь «проверь только папку $arguments». строка вида !`git diff HEAD` выполняется до того, как claude прочитает skill, и подставляет вывод команды. так в документации устроен пример skill, который описывает незакоммиченные изменения.

шаг 5. реши, кто вызывает skill

если skill что-то делает снаружи — деплоит, отправляет, публикует, — добавь во frontmatter disable-model-invocation: true. тогда claude не запустит его сам, только ты командой, а его описание даже не будет занимать контекст. обратный флаг user-invocable: false прячет skill из меню /: им пользуется только агент, это удобно для справочников. ещё два полезных поля: allowed-tools — какие инструменты можно без подтверждения, пока skill работает, и context: fork — запустить skill в отдельном субагенте.

документация даёт хороший ориентир: если ты в третий раз вставляешь в чат один и тот же порядок действий, пора делать skill.

чем skill отличается от CLAUDE.md, slash-команд, субагентов и mcp

эти вещи путают чаще всего. коротко по документации claude code:

про slash-команды в документации сказано прямо: пользовательские команды объединили со skills. файл .claude/commands/deploy.md и skill .claude/skills/deploy/SKILL.md оба создают /deploy, старые файлы продолжают работать. но у skill есть папка для файлов, автоматическая загрузка и контроль вызова, так что новые лучше сразу делать как skills.

про CLAUDE.md: его советуют держать короче 200 строк, а справочный материал выносить в skills. правило «используй pnpm, а не npm» живёт в CLAUDE.md, длинный чек-лист релиза — в skill.

mcp даёт агенту инструменты и доступ к внешней системе, а skill учит, как этими инструментами пользоваться. они хорошо работают в паре: mcp подключает базу, skill описывает её схему и типовые запросы. субагент — это не инструкция, а отдельный исполнитель: skill можно запустить внутри субагента через context: fork, а субагенту можно заранее выдать нужные skills.

и важная оговорка: skill — это просьба, а не гарантия. если правило должно выполняться каждый раз (например, не трогать .env), документация советует хук, который заблокирует действие, а не строчку в инструкции.

где брать готовые claude code skills

готовые skills в claude code чаще всего ставятся через плагины. плагин — это упаковка: внутри могут быть skills, субагенты, хуки и mcp-серверы. плагины собраны в маркетплейсы — каталоги в github-репозиториях. вот что реально работает сейчас.

официальный маркетплейс anthropic

маркетплейс claude-plugins-official claude code добавляет сам при первом запуске интерактивной сессии в терминале. набери /plugin: на вкладке discover — список плагинов с поиском. тот же каталог в браузере — на claude.com/marketplace/plugins. установка:

/plugin install commit-commands@claude-plugins-official

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

репозиторий anthropics/skills на github

если ищешь skills claude github, начинай с github.com/anthropics/skills — это публичный репозиторий anthropic с примерами skills, спецификацией формата и шаблоном. в claude code он подключается как маркетплейс:

/plugin marketplace add anthropics/skills
/plugin install example-skills@anthropic-agent-skills
/plugin install document-skills@anthropic-agent-skills

внутри есть, например, skill-creator, frontend-design, mcp-builder, webapp-testing и документные docx, pdf, pptx, xlsx. у многих skills лицензия apache 2.0, а у документных — source-available, то есть код открыт для чтения, но это не open source. и честная оговорка из readme: skills выложены для демонстрации и обучения, перед важной работой их нужно проверить у себя.

community и сторонние маркетплейсы

у anthropic есть ещё community-маркетплейс со сторонними плагинами, которые авторы прислали в anthropic. он подключается командой /plugin marketplace add anthropics/claude-plugins-community, а плагины ставятся с суффиксом @claude-community. любой другой маркетплейс — это чей-то репозиторий с файлом .claude-plugin/marketplace.json, и такие anthropic не проверяет. в старых гайдах встречается anthropics/claude-code — это демо-маркетплейс с примерами, а не официальный.

и самый простой путь — скопировать чужую папку со SKILL.md в ~/.claude/skills/. но тогда вся проверка на тебе.

какие skills поставить первыми

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

• встроенные, которые уже есть. /code-review ищет ошибки в текущих правках, /simplify чистит изменённый код, /run и /verify запускают приложение и проверяют, что правка реально работает, а не только проходит тесты.
• commit-commands из официального маркетплейса — команды для коммита, пуша и pull request.
• skill-creator — помогает написать свой skill: собрать задачу, набросать SKILL.md, прогнать тестовые запросы и довести описание, чтобы skill срабатывал вовремя. есть в anthropics/skills и в официальном маркетплейсе.
• frontend-design — если делаешь сайты и интерфейсы.
• два-три своих skill под задачи, которые повторяются каждую неделю: проверка перед выкладкой, твой формат коммитов, структура лендинга.

лишние легко найти: в /skills список сортируется по токенам клавишей t, а у плагинов из официального маркетплейса в карточке показана стоимость в контексте.

коротко про дизайн. frontend-design (его ищут как frontend design skill claude) задаёт агенту продуманное визуальное направление — типографику, цвет, композицию — вместо шаблонных решений. а claude design skill в самом claude code — встроенная команда /design: она рисует макеты экранов и лендингов на холсте как артефакт. ей нужна версия v2.1.265 или новее и аккаунт, где доступен шаблон design. подробный разбор дизайн-скиллов будет отдельной статьёй.

как не поставить вредный skill

документация anthropic формулирует жёстко: используй skills только из надёжных источников — свои или от anthropic. вредный skill может заставить агента вызывать инструменты и выполнять код не по заявленному назначению, вплоть до утечки данных. плагин вообще может выполнять произвольный код на твоём компьютере с правами твоего пользователя. причём разрешения и песочница claude code касаются вызовов самого агента, а хуки и mcp-серверы плагина работают вне песочницы. перед установкой:

1. проверь источник. claude plugin marketplace list показывает, откуда добавлен каждый маркетплейс. имена вроде claude-plugins-official claude code принимает только из репозиториев github.com/anthropics, так что подделать официальный каталог нельзя.
2. открой карточку в /plugin. раздел will install перечисляет skills, агентов, хуки и mcp-серверы плагина. но что именно запускает хук, там не видно.
3. прочитай код. в skill — все файлы: SKILL.md, скрипты, ресурсы. ищи сетевые запросы, чтение .env и ключей, действия, которые не совпадают с описанием. в плагине — ещё hooks/hooks.json, .mcp.json и всё в папке bin/.
4. посмотри на allowed-tools. это поле разрешает инструменты без подтверждения, пока skill работает, и доверие к папке проекта его не ограничивает. в чужом репозитории со своими skills стоит заглянуть в .claude/skills/ до того, как запускать там claude code.
5. помни про вставки !`команда`. они выполняются до того, как claude прочитает skill. правила разрешений к ним применяются, а если такие вставки тебе не нужны вовсе, их отключает настройка "disableSkillShellExecution": true.
6. осторожно с внешними адресами. skill, который тянет данные из интернета, может получить вредные инструкции, даже если сам написан честно.
7. следи за обновлениями. при автообновлении проверенные тобой файлы могут поменяться. у сторонних маркетплейсов оно по умолчанию выключено — не включай его вслепую.

если перестал доверять плагину, удали его командой claude plugin uninstall с той областью, в которой ставил. не доверяешь автору — удали и маркетплейс: вместе с ним уйдут все плагины из него.

вопросы

claude не подхватывает мой skill. что делать?

проверь путь: ~/.claude/skills/имя/SKILL.md, файл называется ровно так, frontmatter начинается с первой строки. посмотри, есть ли skill в /skills. если папку skills ты создал посреди сессии, выполни /reload-skills. и перепиши description: добавь, когда skill использовать, словами из твоих запросов.

skills в claude.ai и в claude code — одно и то же?

формат один — папка со SKILL.md. но в claude.ai свои skills загружают zip-архивом в настройках (тарифы pro, max, team и enterprise с включённым выполнением кода), в api — через skills api, а в claude code это просто папки на диске. по документации платформы skills claude, загруженные в одно место, сами в другом не появляются.

сколько skills можно поставить?

жёсткого предела в документации нет, но описание каждого skill постоянно сидит в контексте. чем больше похожих описаний, тем чаще claude берёт не тот skill или пропускает нужный. держи только те, которыми пользуешься, а skills с действиями переводи в ручной вызов через disable-model-invocation: true.

как поделиться своим skill с командой?

самый простой способ — положить его в .claude/skills/ проекта и закоммитить. если один и тот же набор нужен в нескольких репозиториях, упакуй его в плагин и выложи свой маркетплейс на github: коллеги подключат его через /plugin marketplace add. про сам вайбкодинг и то, как в нём делить работу с агентом, — в статье вайбкодинг — что это и как он работает на практике.

источники

• extend claude with skills — документация claude code
• extend claude code: claude.md, skills, субагенты, mcp, хуки — документация claude code
• commands: встроенные команды и skills — документация claude code
• install and manage plugins — документация claude code
• anthropic's marketplaces — документация claude code
• plugin security and trust — документация claude code
• agent skills overview — документация платформы claude
• anthropics/skills — github