Agent Skills — кросс-вендорный формат инструкций для LLM-агентов
По состоянию на 2026-10-20 Agent Skills — это открытый стандарт, опубликованный Anthropic в декабре 2025: в SKILL.md обязательны только name и description, содержимое загружается по трём уровням, а Claude Code, claude.ai, Claude API и OpenAI Codex / ChatGPT читают один и тот же файл.
Что такое Skills и как они соотносятся с Plugin и MCP
Skill — это каталог, содержащий SKILL.md (поля name и description в YAML frontmatter и инструкции в markdown) и необязательные каталоги scripts/, references/, assets/. Официально это переиспользуемый ресурс на основе файловой системы: модель сначала сопоставляет запрос с description, затем читает нужный текст и скрипты, причём в контекст попадает только вывод скрипта. В отличие от Plugin (пакеты функций клиента) и MCP (протокол внешних инструментов), Skill — это не инструмент и не клиентская возможность, а «инструкции, как делать». Один плагин может включать несколько Skills, а Skill может ссылаться на MCP-инструменты.
Спецификация SKILL.md: обязательные поля и минимальный пример
SKILL.md использует YAML-frontmatter для name и description, а основной текст — markdown с инструкциями. Пример: по спецификации обязательны только name и description; license, compatibility, metadata и allowed-tools необязательны, причём allowed-tools помечен как экспериментальный. Минимальный пример из официальной документации: name — pdf-processing, а description описывает извлечение текста и таблиц из PDF, заполнение форм и объединение документов — такой skill нужен, когда пользователь упоминает PDF, формы или извлечение документов. name — максимум 64 символа, только строчные буквы, цифры и дефисы, без дефисов в начале и конце; description — непустое поле, максимум 1024 символа. Каталог: skill-name/SKILL.md плюс необязательные scripts/, references/ и assets/. В тексте записаны шаги для модели, например: 1. Извлечь из сообщения пользователя файлы для обработки; 2. Вызвать ./scripts/extract.py и вывести результат. Модель сама загружает этот skill, увидев запрос про PDF.
Официальный репозиторий skills и примеры партнёров
Официальный репозиторий anthropics/skills публикует набор эталонных реализаций, и его README делит их на четыре категории: креативный дизайн, техническая разработка, корпоративная коммуникация и работа с документами; docx, pdf, pptx и xlsx — это версии с доступным исходным кодом, на которых стоят документные возможности Claude, а большинство остальных открыты по лицензии Apache 2.0. На стороне платформы есть и готовые документные skills: PowerPoint (pptx), Excel (xlsx), Word (docx) и PDF (pdf), готовые к работе в claude.ai и в API. В репозитории также есть шаблон skill и копия спецификации, а в Claude Code репозиторий можно зарегистрировать как маркетплейс плагинов и ставить skills оттуда; в разделе Partner Skills README сейчас показан Claude skill от Notion. Сообщественный агрегатор SkillsMP (skillsmp.com) сам описывает себя как независимый проект сообщества, который собирает публичные репозитории GitHub, чтобы упростить поиск skills.
Кросс-вендорная совместимость и корпоративное распространение
После того как Anthropic в декабре 2025 открыла Skills как стандарт, в официальной документации OpenAI сказано, что Codex и ChatGPT читают один и тот же SKILL.md: Codex загружает локальные skills из $CWD/.agents/skills, $HOME/.agents/skills и /etc/codex/skills, их можно вызвать явно через /skills или $, а также автоматически по совпадению с description. Один и тот же SKILL.md работает в Claude Code, Codex CLI и ChatGPT — пишем один раз, разворачиваем у разных вендоров, но между продуктами автоматической синхронизации нет: skills, загруженные в claude.ai, нужно отдельно загружать в API, skills, загруженные через API, в claude.ai недоступны, а skills в Claude Code хранятся как локальные файлы. Для организаций важно другое: кастомные skills в claude.ai принадлежат отдельному пользователю, и Anthropic прямо пишет, что claude.ai не поддерживает централизованное администрирование и распространение skills по всей организации; Claude Enterprise может включить сканирование содержимого skills для загруженных в claude.ai и Claude Cowork, а skills, загруженные через Skills API, не сканируются, и один запрос API поддерживает не более 20 skills.
FAQ
Skills и Custom Subagents — одно и то же?
Нет. Custom Subagent — единица диспетчеризации Claude Code со своим prompt, инструментами и правилами. Skill — пакет инструкций более высокого уровня, который может быть загружен главным агентом или любым субагентом. Один субагент может ссылаться на несколько скиллов: официальный способ — поле skills, которое подгружает полное содержимое skill в контекст субагента при старте, а обратный сценарий тоже работает — skill с context: fork выполняется в форке субагента.
Можно ли через Skill жёстко запретить какое-то поведение модели?
Нет — Skills это «рекомендации и инструкции», модель может отклоняться под давлением. Официально skill определяется как инструкции и скрипты, поэтому вопрос в том, следует ли им модель, решается через оценку (в официальном чек-листе есть пункты про соблюдение инструкций и точность срабатывания триггера). Для настоящих ограничений используйте механизмы Claude Code: disallowed-tools убирает инструменты из доступного пула, пока skill активен, allowed-tools заранее разрешает инструменты, а disable-model-invocation: true не даёт модели запускать этот skill самой. Жёсткие правила не стоит писать только в skill — skill для того, «как делать правильно».
Могут ли Codex и ChatGPT использовать тот же SKILL.md?
Да. Skills — это markdown-репозитории текста, git clone и используете локально: Claude Code читает их из ~/.claude/skills/ или .claude/skills/, Codex — из каталогов .agents/skills. В паре с шлюзом QCode к Claude/Codex/GPT один и тот же SKILL.md работает у разных вендоров. В официальной документации сказано, что Skills строятся на открытом стандарте, файл SKILL.md обязан содержать name и description, а Codex и ChatGPT сначала читают name и description, а полный SKILL.md — только когда решили его использовать.
Связанные руководства
Используйте Agent Skills кросс-вендорно через QCode
QCode даёт доступ к Claude / GPT / китайским моделям — все совместимы со стандартом Agent Skills. Пишите один раз, запускайте везде.
Подключить план QCodeСоздать аккаунт QCode
Один ключ для Claude, GPT и китайских моделей, оплата по токенам — актуальные цены на /models.