Agent Skills в Claude Code: как работают, где взять и как не поставить вредоносный скилл

Коротко (TL;DR)

Agent Skills (скиллы, или «навыки» Claude Code) — это папки с файлом-инструкцией SKILL.md, которые дают агенту готовую «процедуру»: как делать конкретную задачу вашим способом. Claude сам решает, когда подгрузить скилл, — по короткому описанию в его заголовке. Пока задача не совпала с описанием, скилл не занимает контекст.

Что нужно знать за минуту:

• Скилл — это не плагин и не программа, а размеченный текст (Markdown + необязательные скрипты и файлы). Написать свой можно за пять минут.
• Скиллы встроены в подписку: они доступны на тарифах Pro, Max, Team и Enterprise без доплаты; на бесплатном Claude.ai их нет (по данным на запуск открытого стандарта, декабрь 2025).
• Готовые скиллы ставятся одной командой из официального маркетплейса anthropics/skills или кладутся руками в папку ~/.claude/skills/.
• Формат SKILL.md с декабря 2025 — открытый стандарт: тот же файл читают Cursor, VS Code, Codex CLI и ещё три десятка инструментов. Учите один формат — работает везде.
• Главный риск — сторонние скиллы из непроверенных каталогов: аудит Snyk нашёл 76 заведомо вредоносных. Ниже разберём, как отличить безопасный.

Дальше — как это устроено под капотом, пошаговая установка, какие скиллы реально стоит поставить и честный разбор рисков.

Что такое Agent Skills простыми словами

Skill в Claude Code — это папка с инструкцией, которая учит агента выполнять определённую задачу по заданному образцу. Представьте стопку памяток на рабочем столе: «как мы оформляем отчёт», «как собрать PDF из данных», «как проверять чужой код». Claude умеет читать эти памятки и брать нужную ровно тогда, когда она пригодится.

Bybit · Rewards Hubдо $30,100Внеси депозит, торгуй 14 дней — и забери награды в Rewards HubЗабрать бонус →

Технически скилл — это каталог с обязательным файлом SKILL.md внутри. В начале файла — YAML-заголовок с именем и описанием, дальше — сам текст инструкции. К скиллу можно приложить скрипты, шаблоны и справочники, но минимум — это один Markdown-файл.

Хуки Claude Code: как автоматизировать действия агента и не подорваться на своих же настройках

MCP в Claude Code: как подключить серверы, не сжечь контекст и когда он не нужен

Плагины в Claude Code: как установить, создать свой маркетплейс и не поймать вредоносный

SKILL.md без магии: собираем свой скилл Claude Code по инженерным паттернам

Память Claude Code: Auto Memory, /memory и почему агент забывает

Важно понять, зачем скиллы вообще нужны, а не только как их ставить. Инженеры Anthropic делят пользу на две части:

• Capability uplift — скилл даёт то, чего агент раньше не умел (например, собирать корректный .xlsx с формулами).
• Encoded preference — скилл кодирует ваш способ делать то, что Claude и так умеет (ваш стиль коммитов, структуру статьи, правила ревью).

Anthropic анонсировала Agent Skills 16 октября 2025 года — сначала как фичу внутри Claude Code, Claude.ai и API. А 18 декабря 2025 года формат опубликовали как независимый открытый стандарт со спецификацией на agentskills.io. В первые же двое суток его поддержали Microsoft (VS Code и GitHub Copilot) и, по сути идентичной архитектурой, OpenAI в ChatGPT и Codex CLI. К марту 2026 один и тот же SKILL.md читали более 32 инструментов. Это и есть ответ на вопрос «зачем учить именно этот формат»: скилл, написанный для Claude Code, переносится в другие агенты без переделки.

Как это работает: progressive disclosure и SKILL.md

Ключевая механика скиллов называется progressive disclosure — «раскрытие по мере надобности». Она решает проблему, из-за которой раньше нельзя было «дать агенту сто инструкций»: они забили бы весь контекст и модель бы «тупела».

Работает это в три уровня:

1. Метаданные (всегда в контексте). При старте Claude Code читает у каждого скилла только имя и описание — примерно 100 токенов на скилл. Этого достаточно, чтобы понять, когда скилл пригодится.
2. Тело скилла (грузится при совпадении). Если задача совпала с описанием, подгружается полный текст SKILL.md — обычно меньше 5000 токенов.
3. Дополнительные файлы (по требованию). Скрипты, справочники и шаблоны из папки скилла читаются, только когда до них дошло дело.

Именно поэтому десятки установленных скиллов почти не «съедают» контекст в простое: пока задача не совпала с описанием, в окне висят только их короткие «визитки».

Из чего состоит SKILL.md

Минимальный скилл выглядит так:

SpaceX · xStockSpaceX — частная компания. Торгуй её токеном на Bybit за крипту.Торговать SpaceX →

my-skill/
└── SKILL.md

А «взрослый» — так:

brand-guidelines/
├── SKILL.md        # главная инструкция (обязательно)
├── scripts/        # опционально: исполняемый код
├── references/     # опционально: справочные материалы
└── assets/         # опционально: шаблоны, картинки, данные

Сам SKILL.md начинается с YAML-заголовка. Здесь есть тонкость, на которой путаются новички. Общая спецификация Agent Skills описывает два поля как обязательные:

• name — строчные буквы, цифры и дефисы, до 64 символов, совпадает с именем папки.
• description — что скилл делает и когда его применять.

Но документация именно Claude Code CLI формулирует мягче: «все поля опциональны, рекомендуется только description, чтобы Claude знал, когда использовать скилл». Разница не в противоречии источников, а в уровне: спецификация задаёт стандарт, конкретная реализация в CLI прощает мелочи. Практический вывод один: description — самое важное поле. Плохое описание — и скилл просто не сработает, потому что модель не поймёт, когда он нужен.

Разница на примере. Слабое описание — «работа с таблицами»: слишком общо, модель не понимает, в каких случаях его брать. Сильное — «Собирает и редактирует файлы .xlsx с формулами, сводными таблицами и форматированием; используй, когда нужно выгрузить данные в Excel». Во втором варианте есть и что скилл делает, и когда его применять, — именно по этой связке Claude принимает решение о подгрузке. Правило простое: пишите description так, будто объясняете коллеге, в какой ситуации звать этого специалиста.

Официальная рекомендация по размеру — держать SKILL.md короче 500 строк, а детали выносить в отдельные файлы. Это прямое следствие progressive disclosure: чем компактнее тело, тем дешевле его подгрузка.

Где лежат скиллы и на каких тарифах доступны

Claude Code ищет скиллы на четырёх уровнях. Приоритет — от организации к конкретному проекту.

Личные скиллы (в домашней папке) удобны для ваших личных привычек; проектные (в репозитории) — чтобы вся команда получила одинаковые правила через обычный git pull.

По тарифам: скиллы работают на всех поверхностях Claude — в Claude.ai, Claude Code, Agent SDK и API — и включены в планы Pro, Max, Team и Enterprise без доплаты (для API — обычная оплата по токенам). На бесплатном тарифе Claude.ai скиллов нет. Цифры и состав тарифов у Anthropic меняются часто, поэтому актуальную сетку сверяйте на официальном прайсинге на момент чтения.

Как установить скилл: три способа

Способ 1 — официальный маркетплейс (рекомендуется). Готовые скиллы Anthropic ставятся как плагин одной командой:

/plugin marketplace add anthropics/skills

После этого Claude подключит их и будет вызывать автоматически, когда они подходят под задачу. Это самый безопасный путь: код открыт и лежит в официальном репозитории.

Способ 2 — вручную в папку. Скачайте или создайте папку скилла и положите её в ~/.claude/skills/ (для себя) или в .claude/skills/ вашего проекта (для команды). Claude подхватит скилл при следующем запуске.

Способ 3 — сторонние каталоги. Существуют внешние каталоги вроде skills.sh со своим CLI (npx skills add ...). Не путайте их с официальным маркетплейсом: anthropics/skills — это Anthropic, а skills.sh и подобные — сторонние площадки. Ставить оттуда можно, но с осторожностью — почему, разберём в разделе о рисках.

Проверить, что скилл виден, помогает команда /doctor (диагностика окружения) — она в том числе покажет проблемы с подключением скиллов.

Какие скиллы уже встроены и что стоит поставить

Часть скиллов уже встроена в Claude Code и работает без установки (их можно отключить настройкой disableBundledSkills). Среди встроенных — /doctor, /code-review, /batch, /debug, /loop и /claude-api. То есть ревью кода или диагностика доступны сразу «из коробки».

Из готовых к установке — официальные документ-скиллы из репозитория anthropics/skills: docx, pdf, pptx, xlsx. Это те самые скиллы, что стоят за умением Claude собирать Word, PDF, презентации и таблицы. Они source-available (код открыт, но лицензия не полностью свободная).

Чтобы не советовать «полезные скиллы» абстрактно, вот реальный срез популярности со стороннего каталога skills.sh (снимок на 11 июля 2026):

Динамика тоже показательна: официальный репозиторий anthropics/skills за семь месяцев вырос примерно с 20 тысяч звёзд на GitHub (18 декабря 2025, момент публикации открытого стандарта) до ~160 тысяч (11 июля 2026). Экосистема растёт быстро — и это же порождает главный риск.

Skills против MCP, субагентов, команд и Projects

Новичка сбивает с толку, что у Claude Code есть сразу несколько «способов что-то настроить». Разложим по полкам — такой цельной таблицы почти нет ни в одном русскоязычном гайде.

Формула, которую стоит запомнить: MCP подключает Claude к данным, а скилл учит, что с этими данными делать. Они не конкурируют, а дополняют друг друга — типичная связка «MCP для доступа, скилл для процедуры». Если хотите глубже разобраться, как агент вообще работает с внешними источниками через MCP, это отдельная большая тема.

А различие с субагентом короткое: скилл меняет поведение, субагент защищает контекст, MCP добавляет возможность. Это ответы на три разных вопроса, а не на один.

Риски: как не поставить вредоносный скилл

Скилл — это инструкция, которую агент выполняет с вашими правами. Значит, чужой скилл заслуживает того же недоверия, что и любой чужой код. И это не теория.

Масштаб проблемы. 5 февраля 2026 года Snyk опубликовал первый большой аудит экосистемы (исследование ToxicSkills). Из 3984 скиллов на площадках ClawHub и skills.sh:

• 13,4% (534 скилла) содержали хотя бы одну критическую уязвимость;
• 36,8% (1467) — хотя бы один дефект безопасности;
• 76 скиллов несли заведомо вредоносную нагрузку: кражу учётных данных, установку бэкдоров, эксфильтрацию данных. Восемь из них на момент публикации всё ещё были доступны.

Почему обычной осторожности мало. Datadog Security Labs показал коварный механизм. В скилле есть «динамический контекст» — строки вида !`команда`, которые выполняются на этапе предобработки, до того как модель вообще увидит содержимое скилла. Это официальная механика: «каждый ! выполняется сразу, Claude видит только результат». В демонстрации Datadog агент выполнил вредоносную команду и лишь потом «заявил», что отказывается её выполнять — команда к тому моменту уже отработала. То есть надежда «Claude сам откажется от подозрительного» здесь не срабатывает.

Но без паники. Картина не апокалиптическая — это стоит держать в фокусе, чтобы риск не выглядел радикальнее, чем он есть на практике. Основной поток вредоносных скиллов идёт через сторонние реестры — прежде всего ClawHub, каталог скиллов для стороннего агента OpenClaw, а не через официальный маркетплейс Anthropic. Практический вывод простой и проверяемый цифрами, а не запугиванием:

• Ставьте скиллы из официального репозитория anthropics/skills или из репозиториев, которым доверяете.
• Читайте SKILL.md перед установкой — особенно ищите строки с !`...` и обращения к сети.
• Не тащите скиллы из случайных каталогов «потому что удобно одной командой».

Другие ограничения

Помимо безопасности есть две бытовые проблемы. Первая — раздувание контекста: по наблюдениям практиков, когда одновременно срабатывают три-четыре скилла, качество ответов может падать (официально задокументирован смежный лимит — после авто-компакции у повторно подгружаемых скиллов общий бюджет 25 000 токенов). Вторая — скилл не активируется: чаще всего причина в размытом description. Официальный троблшутинг Anthropic прямо называет нечёткое описание главной причиной, по которой Claude «не видит» нужный скилл.

FAQ

Чем скилл отличается от файла CLAUDE.md? CLAUDE.md читается всегда и задаёт общие правила проекта. Скилл подгружается выборочно — только когда задача совпала с его описанием. Грубо: CLAUDE.md — это «правила на стене», скилл — «памятка, которую достают под конкретную работу».

Нужно ли уметь программировать, чтобы написать свой скилл? Нет. Минимальный скилл — это папка с одним Markdown-файлом SKILL.md, где по-человечески написано, что и когда делать. Скрипты — опция, а не требование. Разбор паттернов и создание своих скиллов — тема отдельного продвинутого гайда.

Скиллы работают только в Claude Code? Нет. С декабря 2025 SKILL.md — открытый стандарт, и его читают Cursor, VS Code, Codex CLI, Gemini CLI и ещё десятки инструментов. Формат один на всех.

Сколько скиллов можно держать установленными? Технически — сколько угодно: их «визитки» стоят около 100 токенов каждая. Но если несколько скиллов начинают срабатывать одновременно на одну задачу, ответы могут деградировать. Держите набор осмысленным и с чёткими описаниями.

Где официально брать проверенные скиллы? В репозитории anthropics/skills (команда /plugin marketplace add anthropics/skills). Там же лежат документ-скиллы, которыми Claude собирает Word, PDF, презентации и таблицы. Сторонние каталоги — на свой риск и только после чтения кода.