Codex Skills: что это, как создать SKILL.md и настроить в 2026

Короткий ответ: скиллы у Codex есть, и это не самодельный обходной путь, а штатный механизм. Codex читает папки со скиллами, где каждый скилл описан файлом SKILL.md, и подключает нужный сам, когда задача совпадает с описанием. Официальная документация OpenAI называет это Skills и прямо говорит, что механизм построен на открытом стандарте agent skills, том же, вокруг которого выстроены навыки у других агентов. Ниже: как устроен скилл, куда класть файлы, чем скиллы отличаются от AGENTS.md, MCP и устаревших custom prompts, и как собрать свой первый скилл за один вечер.

Оговорка про форм-фактор. Основной способ пользоваться Codex для большинства, это десктопное приложение ChatGPT для Windows и macOS: чат и агент в одной программе. Скиллы и конфиги ниже, это папки и текстовые файлы на вашем компьютере, они работают в связке с CLI и IDE-расширением. Если Codex ещё не стоит, начните с разбора о том, как установить Codex.

Что такое скилл в Codex

Скилл, это папка с инструкцией, которую агент подключает по требованию. Вы один раз описываете повторяющийся рабочий процесс (как готовить релиз, как проверять вёрстку, как оформлять коммиты), и дальше Codex выполняет его одинаково в каждой новой сессии, без напоминаний. По документации папка скилла состоит из таких частей:

• SKILL.md, единственный обязательный файл: сама инструкция плюс метаданные.
• scripts/, необязательная папка с исполняемым кодом, если процессу нужны команды.
• references/, необязательная папка с документацией и справочными материалами.
• assets/, необязательная папка с шаблонами и заготовками.
• agents/openai.yaml, необязательный файл с настройками отображения и зависимостями.

В YAML-шапке SKILL.md обязательны всего два поля: name (идентификатор скилла) и description (когда скилл должен срабатывать, а когда не должен). Второе поле важнее, чем кажется: именно по описанию Codex решает, брать скилл в работу или нет. Расплывчатое описание, это скилл, который либо не включается никогда, либо лезет туда, куда не просили.

Про экономию контекста продумано отдельно. Codex сначала подгружает только имя, описание и путь каждого скилла, и по документации это занимает не больше 2% контекста (порядка 8 000 символов). Полный текст инструкции загружается только тогда, когда агент реально выбрал скилл для задачи. То есть десять скиллов в папке не съедают контекст просто фактом своего существования.

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

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

• .agents/skills в текущей папке: скиллы под конкретную часть проекта.
• .agents/skills в корне репозитория: скиллы, общие для всей команды, они лежат в репозитории и приезжают к коллегам вместе с кодом.
• $HOME/.agents/skills: ваши личные скиллы, доступные во всех проектах.
• /etc/codex/skills: системные настройки уровня машины.
• Скиллы, встроенные в сам Codex.

Вывод простой: личное складывайте в домашнюю папку, командное кладите в репозиторий и коммитьте. Скилл в репозитории, это единственный способ добиться, чтобы у всех участников агент вёл себя одинаково.

По теме: Обучение программированию и нейросетям: как учиться с ИИ в 2026

Как собрать свой первый скилл

1. Выберите процесс, который вы уже повторяли минимум трижды и каждый раз объясняли агенту заново. Хороший кандидат: проверка перед публикацией, оформление README, единый стиль текстов.
2. Позовите встроенного помощника. В сессии Codex наберите $skill-creator: это штатный скилл-конструктор, он проведёт по созданию структуры и шапки. Готовые скиллы можно поставить через $skill-installer.
3. Опишите процесс в SKILL.md так, как объясняли бы человеку: по шагам, с примерами того, что считается хорошим результатом, и с явным перечислением того, чего делать нельзя.
4. Отдельно вылижите поле description. Напишите, при каких задачах скилл нужен и при каких его брать не надо: это ваш единственный рычаг управления автоподключением.
5. Проверьте, что скилл виден. Команда /skills покажет список доступных, а вызвать конкретный можно явно через $имя-скилла.
6. Прогоните на реальной задаче и допишите инструкцию по тому, где агент оступился. Скилл дорабатывается итерациями, с первого раза идеально не выходит.

Вызов бывает двух видов: явный, когда вы сами пишете $skill-name или выбираете из /skills, и неявный, когда Codex сам подобрал подходящий скилл по описанию задачи. Если скилл мешает, отключать его насовсем не обязательно: в ~/.codex/config.toml есть блок [[skills.config]] с путём к SKILL.md и флагом enabled = false.

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

AGENTS.md: правила, которые действуют всегда

Скиллы подключаются по ситуации, а AGENTS.md, это то, что Codex читает перед работой в любом случае. Туда идут постоянные вещи: команды сборки и тестов, соглашения проекта, ваши требования к результату, ошибки, которые агент уже повторял.

По документации файлы ищутся так: сначала глобальный ~/.codex/AGENTS.md (или AGENTS.override.md), потом Codex идёт от корня репозитория к текущей папке и собирает встреченные AGENTS.md. Файлы складываются сверху вниз, и чем ближе файл к рабочей папке, тем выше приоритет его указаний. Суммарный объём по умолчанию ограничен 32 KiB, лимит меняется параметром project_doc_max_bytes.

Правило выбора простое. Инструкция нужна почти всегда и коротка, это AGENTS.md. Отдельная процедура со своими шагами, примерами и скриптами, нужная раз в неделю, это скилл. Складывать процедуры в AGENTS.md невыгодно: они занимают контекст в каждой сессии, даже когда вы правите опечатку.

По теме: Обучение вайбкодингу: план освоения навыка за 4 недели

MCP и остальные слои настройки

OpenAI описывает пять слоёв кастомизации: AGENTS.md (постоянные правила), memories (контекст, который агент выносит из прошлой работы), skills (переиспользуемые процессы), MCP (доступ к внешним системам) и subagents (делегирование задач отдельным агентам с другим набором прав).

MCP отвечает за то, чего нет в вашей папке с кодом: трекеры задач, дизайн-инструменты, документация, внешние API. Сервер добавляется командой codex mcp add, дальше либо команда запуска после -- для локальных серверов, либо --url для серверов по HTTP. Настройки складываются в ~/.codex/config.toml в секцию mcp_servers, а проверить, что сервер поднялся и отдаёт инструменты, можно командой /mcp внутри сессии. Протокол общий для индустрии, поэтому серверы часто переиспользуются между агентами: как он устроен, мы разбирали на примере MCP у Claude. Связка скилл плюс MCP работает лучше всего: MCP даёт доступ, скилл описывает, что именно с этим доступом делать.

Custom prompts устарели: что с ними делать

Раньше переиспользуемые инструкции в Codex оформляли через custom prompts: markdown-файлы в ~/.codex/prompts/, которые вызывались слэш-командой вида /prompts:имя. Сейчас в документации прямо написано, что custom prompts устарели, и вместо них рекомендуются скиллы.

Причина в ограничениях: промпт вызывался только вручную и лежал в локальной папке, коллегам он не доставался. Скилл умеет и явный вызов, и автоподключение, и живёт в репозитории вместе с проектом. Накопившиеся промпты переносите постепенно: берите те, что вызываете чаще всего, и переписывайте в SKILL.md с внятным описанием для автоподключения. Про слэш-команды и режимы работы в терминале есть отдельный разбор про команды Codex CLI.

По теме: ИИ для вайбкодинга в 2026: какой выбрать под сайт, бота и код

А как это соотносится с Claude Skills

Формат один и тот же: папка, внутри SKILL.md с полями name и description, прогрессивная подгрузка, чтобы не жечь контекст. Документация Codex называет основу открытым стандартом agent skills. Различия в деталях: у Codex скиллы ищутся в .agents/skills, явный вызов идёт через $имя, а список открывается командой /skills. Если вы уже писали навыки для другого агента, логика знакомая, переучиваться почти не придётся, поменяются пути и синтаксис вызова. Устройство навыков со стороны Anthropic мы разбирали в материале про Claude Skills.

Частые вопросы

Нужно ли уметь программировать, чтобы написать скилл?

Нет. SKILL.md, это обычный текстовый файл с инструкцией на человеческом языке и небольшой шапкой из двух полей. Папки scripts/ и assets/ необязательные: если вашему процессу не нужен код, их просто не будет.

Codex сам подключит скилл или его надо звать каждый раз?

Оба варианта рабочие. Агент подбирает скилл сам, ориентируясь на поле description, и он же вызывается вручную через $имя-скилла. Если автоподключение срабатывает не там, где нужно, дело почти всегда в описании: уточните в нём, при каких задачах скилл применять не следует.

Скиллы едят контекст, если их много?

В фоне держатся только имя, описание и путь, и по документации это не больше 2% контекста (около 8 000 символов). Полная инструкция подгружается лишь у того скилла, который агент выбрал под задачу.

Чем скилл отличается от AGENTS.md, если и там, и там текст с правилами?

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

Можно ли поделиться скиллом с коллегами?

Да, и это главное преимущество перед устаревшими custom prompts. Положите папку скилла в .agents/skills в репозитории и закоммитьте: у всех, кто работает с этим кодом, агент будет действовать по одинаковым правилам.