Skills: Codex vs Claude Code — сравнение и совместимость

Skills позволяют упаковать повторяемую процедуру в папку с файлом SKILL.md, чтобы Claude Code подключал инструкции по запросу или автоматически. Ниже — подтверждённые на 3 сентября 2026 года сведения о Claude Code и безопасный порядок проверки кандидата перед переносом в Codex.

🗓️

Актуальность: материал проверен 3 сентября 2026 года. Снимок официальной документации Claude Code содержит спецификацию Skills. Снимок источника OpenAI содержит только ссылку на актуальную страницу Codex, поэтому детали реализации Codex, которых нет в самом снимке, здесь не выдаются за подтверждённые факты. Материал основан на документации; фактический запуск переноса Skill в Codex в переданных данных не выполнялся.

📌

Короткий ответ: Claude Code следует открытому стандарту Agent Skills — формату упаковки инструкций для AI-агентов. Перенос любого Skill в Codex всё равно нужно проверять на практике. Наиболее безопасный кандидат — простой SKILL.md с описанием и инструкциями, без полей и механизмов, специфичных для Claude Code.

Содержание

Что подтверждено официальными источниками
Как устроены Skills в Claude Code
Какие возможности требуют адаптации
Безопасный порядок переноса в Codex
Полезные сценарии
Что делать, если Skill не работает
Тарифы Claude Code

Что подтверждено официальными источниками

Claude Code использует SKILL.md и прямо указывает, что его Skills следуют открытому стандарту Agent Skills. В документации Claude Code этот стандарт дополнен собственными возможностями: управлением вызовом, запуском в контексте субагента и динамической подстановкой результата команд.

По Codex предоставленный официальный снимок содержит только ссылку на страницу developers.openai.com/codex/skills. В нём нет текущей спецификации путей, метаданных, API или интерфейса вызова. Поэтому прежние подробные утверждения о agents/openai.yaml, $skill-name, /v1/skills, Responses API и составе встроенных Skills нельзя считать проверенными по этому набору источников.

Аспект	Claude Code	Codex по доступному снимку
Основной файл	`SKILL.md`	Подробности не раскрыты
Основа формата	Agent Skills	Требуется проверка по актуальной странице документации
Явный вызов	`/skill-name`	Не подтверждён снимком
Автоматическое подключение	По релевантности и описанию Skill	Не подтверждено снимком
Субагентный режим	`context: fork` — отдельный контекст вспомогательного агента	Не подтверждён снимком
Динамический контекст	Команды вида !`command`	Не подтверждён снимком
Управление инструментами	`allowed-tools`, `disallowed-tools`	Не подтверждено снимком

Наличие поля в документации Claude Code не доказывает, что его понимает Codex. Совместимость каждого поля нужно сверять с актуальной документацией целевого агента.

Как устроены Skills в Claude Code

Где хранятся Skills

Уровень	Путь	Область действия
Личный	`~/.claude/skills/<name>/SKILL.md`	Все локальные проекты пользователя
Проектный	`.claude/skills/<name>/SKILL.md`	Текущий проект
Плагин	`<plugin>/skills/<name>/SKILL.md`	Проекты, где включён плагин
Enterprise	Каталог управляемых настроек	Пользователи организации

Claude Code также продолжает поддерживать старые файлы .claude/commands/*.md. Если command и Skill имеют одинаковое имя, приоритет получает Skill.

В монорепозитории Skills могут находиться во вложенных .claude/skills/. Они становятся доступны, когда Claude читает или изменяет файл в соответствующем подкаталоге. Claude Code отслеживает текст SKILL.md в уже наблюдаемых каталогах, поэтому такие изменения обычно подхватываются в текущей сессии без перезапуска. Для нового верхнеуровневого каталога может потребоваться перезапуск.

Поля YAML-заголовка

Поля находятся в YAML-заголовке (frontmatter) между маркерами --- в начале файла. Все поля в Claude Code необязательны, однако description рекомендуется: по нему агент определяет, когда подключать Skill автоматически.

Поле	Назначение	Пример
`name`	Отображаемое имя	`review-api`
`description`	Что делает Skill и когда его применять	`Reviews API changes for compatibility risks`
`when_to_use`	Дополнительные условия автоматического вызова	`Use for public endpoint changes`
`argument-hint`	Подсказка аргументов в меню	`[filename] [format]`
`arguments`	Имена позиционных аргументов для подстановки в содержимое	`filename format`
`disable-model-invocation`	Запрещает автоматический вызов	`true`
`user-invocable`	Управляет доступностью ручного вызова	`false`
`allowed-tools`	Инструменты, разрешённые без нового запроса в текущем ходе	`Read Grep`
`disallowed-tools`	Инструменты, временно исключённые при выполнении	`AskUserQuestion`
`model`	Модель для текущего хода или субагента	`inherit`
`effort`	Уровень вычислительных усилий	`low`, `medium`, `high`, `xhigh`, `max`
`context`	Запуск в отдельном контексте	`fork`
`agent`	Тип субагента при `context: fork`	Зависит от доступных агентов
`background`	Фоновый режим субагента при `context: fork`; `false` заставляет ждать результат	`true` или `false`; требуется с Claude Code v2.1.218
`hooks`	Хуки, которые Claude Code регистрирует при вызове Skill и сохраняет активными до конца сессии	Конфигурация событий
`paths`	Glob-шаблоны, ограничивающие автоматическую активацию	Список шаблонов
`shell`	Оболочка для встроенных `!`-команд	`bash` или `powershell`

Поля вне общего стандарта могут быть проигнорированы другим агентом. Их наличие во frontmatter Claude Code не делает их переносимыми.

Пакетные Skills Claude Code

Официальная документация называет среди пакетных Skills /doctor, /code-review, /batch, /debug, /loop и /claude-api. Отдельная группа помогает запускать и проверять приложение:

Skill	Что делает
`/run`	Запускает приложение и позволяет проверить изменение в работающей системе
`/verify`	Собирает и запускает приложение для проверки результата, не сводя проверку к тестам или проверке типов
`/run-skill-generator`	Записывает рабочий рецепт запуска в проектный Skill

Claude Code доступен в терминале, расширениях IDE, настольном приложении и браузере. Поэтому характеристика «только CLI» устарела. Skills также можно включать для аккаунта claude.ai и использовать в облачных сессиях; локальная синхронизация имеет отдельные ограничения.

Какие возможности требуют адаптации

Следующие механизмы документированы в Claude Code. По доступному снимку Codex их поддержка не подтверждена, поэтому при переносе проверяйте их отдельно:

context: fork, agent и background;
hooks;
allowed-tools и disallowed-tools;
выбор model и effort на уровне Skill;
динамический контекст через !command ;
именованные и позиционные подстановки аргументов;
правила paths;
настройки оболочки через shell;
синхронизация Skills через аккаунт claude.ai;
поведение вложенных .claude/skills/ в монорепозитории.

⚠️

Внимание: не переносите исполняемые команды, хуки и разрешения инструментов вслепую. Даже если другой агент прочитает Markdown, он может проигнорировать управляющее поле или выполнить процедуру в другом контексте безопасности.

Безопасный порядок переноса в Codex

Начните с минимального варианта:

---
name: write-tests
description: Пишет unit-тесты для новых публичных функций в текущем файле
---

1. Найди публичные функции без тестов.
2. Добавь тесты в соответствующий test-файл.
3. Проверь пустые значения и граничные случаи.
4. Запусти подходящий набор тестов и сообщи результат.

Это кандидат на перенос, а не гарантия совместимости. Проверяйте его так:

Сверьте текущие требования Codex на официальной странице Skills.
Создайте копию Skill, сохранив исходный вариант для Claude Code.
Для первого теста оставьте только name, description и обычные Markdown-инструкции.
Удалите или перепишите Claude-специфичные поля, подстановки, хуки и встроенные команды.
Разместите копию в каталоге, который указан в актуальной документации вашей версии Codex.
Перезапустите сессию, если новый Skill не появился автоматически.
Выполните явный тест на безопасной задаче без секретов и необратимых действий.
Проверьте наблюдаемый результат: загрузился ли нужный Skill, соблюдены ли инструкции, запущены ли ожидаемые проверки.
Только после этого добавляйте скрипты, внешние инструменты или автоматический вызов.

Полезные сценарии

Общий Skill только с инструкциями

Задача: выполнять одну и ту же процедуру в Claude Code и Codex.

Условие: Skill содержит только SKILL.md с описанием и нейтральными Markdown-инструкциями.

Действие: храните общее ядро отдельно от платформенной обвязки и не используйте хуки, подстановки команд или специальные разрешения.

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

Ограничение: если процедура зависит от механизма Claude Code, нейтрального файла будет недостаточно.

Skill только для Claude Code

Задача: использовать субагентный режим, хуки или динамический контекст.

Условие: процедура рассчитана именно на Claude Code и его текущую документацию.

Действие: явно пометьте Skill как платформенный и протестируйте каждый используемый механизм в Claude Code.

Проверяемый результат: Skill выполняется в ожидаемом контексте, а хуки и команды дают предусмотренный результат.

Ограничение: другой агент может проигнорировать управляющие поля, поэтому такой Skill нельзя считать переносимым без отдельной адаптации.

Командный репозиторий Skills

Задача: дать команде единый повторяемый процесс.

Условие: проектный Skill хранится вместе с кодом и проходит ревью.

Действие: зафиксируйте входные данные, ожидаемые действия и признак успеха; для Claude Code проектные Skills размещаются в .claude/skills/.

Проверяемый результат: участник команды получает тот же файл и может пройти тот же проверочный сценарий.

Ограничение: для поддержки другого агента отдельно проверьте его каталог, поля и порядок загрузки по актуальной документации.

Что делать, если Skill не работает

Убедитесь, что файл называется ровно SKILL.md.

Проверьте, что YAML frontmatter начинается с первой строки файла.

Добавьте конкретное description с задачей и условиями применения.

Для Claude Code проверьте правильность каталога .claude/skills/<name>/.

Если после запуска создан новый верхнеуровневый каталог Skills, перезапустите Claude Code.

При изменении Skill в уже существующем наблюдаемом каталоге проверьте, подхватился ли новый текст в текущей сессии.

Проверьте, не конфликтует ли имя с другим Skill, command или пакетным Skill.

Для вложенного Skill откройте файл в соответствующем подкаталоге проекта.

Если Skill не должен вызываться автоматически, проверьте disable-model-invocation.

При переносе временно удалите все платформенные поля и оставьте только инструкции.

Не считайте отсутствие ошибки доказательством совместимости: проверьте фактический результат процедуры.

Тарифы Claude Code

На 3 сентября 2026 года Claude Code входит во все платные индивидуальные планы Claude. Pro стоит $20 при ежемесячной оплате или $17 в месяц при годовой оплате за $200. Max начинается от $100 в месяц и предлагает выбор в пять или двадцать раз большего объёма использования относительно Pro за пятчасовую сессию.

Лимиты общие для Claude в вебе, приложениях и Claude Code. Они включают скользящее пятчасовое окно, а для платных планов действуют дополнительные недельные ограничения. Объём зависит от длины и сложности сессий, выбранной модели и функций, поэтому фиксированного количества сообщений нет. Перед выбором тарифа проверяйте официальную страницу Claude Pricing.

Сравнение стоимости с Codex в этой редакции не приводится: в переданных источниках нет актуального официального снимка тарифов OpenAI.

Вывод

Документация Claude Code описывает развитую систему Skills с автоматическим и ручным вызовом, субагентами, аргументами, хуками и динамическим контекстом. Эти возможности удобны внутри его экосистемы, но усложняют перенос.

Для общего Skill используйте короткий SKILL.md с обычными инструкциями и отдельными проверочными сценариями. Платформенные возможности добавляйте в специализированные варианты после сверки с актуальной документацией каждого агента.

Официальные источники

Следующий шаг

Перенос скилла из Claude в Codex: пошаговое руководство

Связанные материалы

Если вы хотите собрать общий набор Skills для нескольких агентов, полезно заранее разделить переносимое ядро и платформенные расширения.

Если захотите обсудить, как это применить у себя или в команде — пишите в Telegram @pimenov

ИИ-агенты DevTools Методология