Установка скиллов в Codex: 3 рабочих способа в 2026

Ниже — практическая инструкция, как установить skills в Codex разными способами: в desktop-приложении Codex app, в терминале через Codex CLI, вручную через SKILL.md и на уровне репозитория. Команды и пути сверены на Codex CLI 0.116.0 и документации OpenAI от 17 апреля 2026 года.

Skill в Codex — это папка с файлом SKILL.md, где лежит готовый повторяемый процесс для агента. Не просто заметка и не промпт в одну строчку, а упакованная инструкция: когда skill нужен, как его вызывать и что именно он должен делать.

Если говорить по-русски, skills в Codex — это навыки Codex: готовые повторяемые сценарии для агента. Поэтому запросы вроде «установка скиллов Codex desktop», «установка скиллов Codex в терминале» и «как поставить навыки Codex» на практике сводятся к одной и той же задаче: понять, где Codex работает и куда именно класть skill.

Где это вообще работает: CLI, Codex app и IDE extension

Вы правы: Codex — это не только терминал. По актуальным docs OpenAI skills относятся к самому Codex как механизму, а не только к CLI-оболочке. Поэтому важно сразу понимать, где вы с ними столкнётесь.

• Codex CLI: если вы ищете установку скиллов в Codex в терминале, это и есть нужный режим. Здесь удобнее всего ставить, проверять и отключать навыки Codex, потому что под рукой файлы, пути и встроенный $skill-installer.
• IDE extension: у OpenAI есть отдельная документация по IDE extension. Там тоже есть slash-команды, настройки и работа с Codex внутри редактора.
• Codex app: если вы ищете установку скиллов в Codex desktop, в официальной документации OpenAI это называется Codex app. Для него agents/openai.yaml может задавать UI metadata, а сам app синхронизируется с IDE extension.

Почему дальше я всё равно показываю установку через CLI? Потому что это самый универсальный и короткий путь. Даже если вы в основном работаете через Codex app или IDE extension, сами skills всё равно удобнее ставить и хранить через стандартные папки и файловую структуру Codex, а уже потом использовать их из нужного интерфейса.

Быстрый путь: как установить skill в Codex за 2 минуты

Если вам не нужен длинный разбор, а нужен рабочий путь прямо сейчас, делайте так: запускаете Codex, вызываете встроенный установщик, ставите нужный skill и перезапускаете CLI. Это самый короткий сценарий для первого запуска, даже если потом вы планируете пользоваться skill уже из IDE extension или Codex app.

codex

Уже внутри сессии Codex введите:

$skill-installer install the linear skill

После установки закройте текущую сессию и откройте codex заново. Дальше проверьте, что skill подхватился:

/skills

Если нужен не готовый curated-skill по имени, а конкретный экспериментальный навык из официального репозитория OpenAI, можно поставить его сразу по ссылке:

$skill-installer install https://github.com/openai/skills/tree/main/skills/.experimental/create-plan

Где Codex ищет skills

Вот здесь у новичков чаще всего и начинается путаница. Внутри локальной установки Codex можно увидеть разные внутренние папки, но для ручной установки и командной работы ориентироваться нужно на официальные scope-уровни из документации OpenAI.

• Repository scope: папка .agents/skills внутри проекта. Codex проходит по таким папкам от текущей рабочей директории вверх до корня репозитория.
• User scope: папка $HOME/.agents/skills. Skills отсюда доступны вам во всех проектах.
• Admin scope: /etc/codex/skills. Это общий системный уровень для машины или контейнера.
• System scope: встроенные skills, которые уже идут вместе с Codex от OpenAI.

Практическое правило простое. Если skill нужен всей команде в конкретном репозитории, кладите его в .agents/skills и коммитьте в git. Если навык нужен только вам во всех проектах, используйте $HOME/.agents/skills. Внутренние системные каталоги лучше не трогать руками.

Ещё один важный момент: если два skills имеют одинаковое поле name, Codex их не мерджит. Оба могут появиться в селекторах, поэтому имена стоит продумывать заранее.

Способ 1. Установка через $skill-installer

В актуальной поставке Codex CLI уже есть встроенный системный skill skill-installer. Он умеет ставить skills из официального репозитория openai/skills и из других GitHub-репозиториев.

Установка curated skills

Если знаете имя готового навыка, можно ставить его сразу по имени. По умолчанию установщик берёт curated-каталог:

$skill-installer install the gh-address-comments skill
$skill-installer install the linear skill

Установка experimental skills

Экспериментальные skills живут в отдельной папке и их лучше указывать явно:

$skill-installer install the create-plan skill from the .experimental folder

Если так понятнее, можно дать и прямую ссылку на папку навыка в GitHub:

$skill-installer install https://github.com/openai/skills/tree/main/skills/.experimental/create-plan

Установка skills из другого GitHub-репозитория

Если нужный skill лежит не в openai/skills, а в любом другом GitHub-репозитории, установщик тоже это понимает. Полезно, когда команда хранит свои навыки отдельно или вы нашли хороший community workflow.

$skill-installer install from mcporter-team/agent-skills path skills/mcporter

Для приватных репозиториев можно использовать уже настроенные git-креды или заранее экспортировать GITHUB_TOKEN либо GH_TOKEN до запуска Codex.

export GITHUB_TOKEN=ghp_xxxxxxxxxxxxxxxxxxxx
codex

Способ 2. Положить SKILL.md вручную

Если вы пишете свой skill, форкаете чужой или просто хотите хранить всё в проекте без встроенного установщика, достаточно одной правильной папки и одного обязательного файла.

$HOME/.agents/skills/my-skill/
└── SKILL.md

.agents/skills/my-skill/
└── SKILL.md

Минимальный живой пример SKILL.md выглядит так:

---
name: prompt-refiner
description: Переписывает промпты, убирает двусмысленности и добавляет недостающий контекст. Используй, когда пользователь просит улучшить, переписать или уточнить промпт для LLM.
---

# Prompt Refiner

## Что делать
1. Прочитай исходный промпт.
2. Найди двусмысленные или расплывчатые места.
3. Перепиши запрос так, чтобы он стал конкретнее.
4. Верни улучшенную версию отдельным блоком.

Самое важное поле здесь — description. По нему Codex решает, нужно ли подтягивать skill автоматически. Чем точнее там описаны триггеры, тем чаще навык будет включаться по делу, а не случайно.

Кроме SKILL.md внутри skill можно держать папки scripts/, references/, assets/ и опциональный файл agents/openai.yaml. По документации OpenAI он нужен для дополнительных настроек навыка, metadata и политики вызова.

Как сделать skill только для явного вызова

Если не хотите, чтобы Codex подгружал skill автоматически, а хотите вызывать его только вручную через $my-skill, добавьте рядом файл agents/openai.yaml с настройкой:

allow_implicit_invocation: false

По умолчанию allow_implicit_invocation равно true. То есть Codex может подключить навык сам, если задача совпала с его описанием.

Способ 3. Поставить skill на уровень репозитория

Для командной работы это обычно лучший вариант. Вы кладёте skill в .agents/skills, коммитите его в проект, и дальше все, кто запускают Codex внутри этого репозитория, получают один и тот же процесс работы.

Это удобно для повторяемых задач: код-ревью, локальные правила фронтенда, release-checklist, работа с вашей инфраструктурой, поддержка MCP-серверов, внутренние playbook’и команды.

mkdir -p .agents/skills/security-review
$EDITOR .agents/skills/security-review/SKILL.md

Если у вас монорепо или вложенные директории, это особенно полезно: root-level skills видны всем, а skills в более глубоких папках можно делать под конкретный сервис или модуль.

Как проверить, что skill действительно подхватился

Проверка всегда одна и та же. Сначала смотрите список навыков:

/skills

Потом вызываете skill явно:

$prompt-refiner

И, если skill рассчитан на автоматический вызов, даёте Codex задачу, которая совпадает с его description. Если навык не сработал, почти всегда причина либо в слишком расплывчатом описании, либо в том, что вы не перезапустили CLI после установки.

Как отключить skill без удаления

Удалять папку не обязательно. В документации OpenAI есть штатный способ временно выключить skill через ~/.codex/config.toml:

[[skills.config]]
path = "/Users/you/.agents/skills/my-skill/SKILL.md"
enabled = false

После изменения файла снова перезапустите Codex. Чтобы вернуть skill обратно, либо поставьте enabled = true, либо удалите этот блок целиком.

Типичные ошибки при установке skills в Codex

Skill не появился в /skills

Сначала проверьте перезапуск. Потом — путь. Для личного уровня это $HOME/.agents/skills, для проекта — .agents/skills. Дальше проверьте YAML-фронтматтер: блок с ---, поля name и description должны быть валидными.

Skill есть, но не триггерится сам

Проверьте description. Если там написано что-то вроде “помогает работать с кодом”, Codex не поймёт, когда именно его включать. Описание должно содержать конкретные сценарии: когда пользователь просит сделать код-ревью, улучшить промпт, проверить SEO, почистить тесты и так далее.

Не ставится из приватного GitHub

Проверьте git-доступ или экспортируйте GITHUB_TOKEN / GH_TOKEN до запуска Codex. Встроенный установщик умеет работать и с приватными репозиториями, но ему всё равно нужны ваши креды.

Два skills с одинаковым именем

Codex их не объединит. Оба навыка останутся видимыми, и дальше вы будете путаться, какой из них реально вызывается. Лучше сразу следить за уникальностью поля name.

Чем skills отличаются от AGENTS.md

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

Skills — наоборот, не должны загружаться всегда. Они используют progressive disclosure: сначала Codex видит только metadata навыка, а полный SKILL.md подгружает лишь тогда, когда skill реально нужен. Поэтому skills хороши для переиспользуемых процессов, а AGENTS.md — для постоянной памяти проекта.

Простое правило такое:

• Если инструкция относится к конкретному репозиторию и нужна всегда — это AGENTS.md.
• Если это переиспользуемый процесс, который нужен не в каждой задаче, — это skill.

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

Не пытайтесь за один вечер превратить Codex в ёлку из двадцати навыков. Для старта обычно хватает трёх вещей:

• один skill под поиск или организацию работы;
• один skill под ваш основной workflow, например ревью или фронтенд;
• один свой project-skill под правила конкретного репозитория.

Если хочется сначала понять саму идею skills без привязки только к Codex, посмотрите ещё наш общий гайд по skills для AI-агентов и 10 рабочих приёмов работы с Claude. Это хорошая база перед тем, как раздувать себе стек навыков.

Что важно запомнить

Если упростить всё до одного короткого вывода, то он такой: для быстрого старта ставьте навык через $skill-installer, для личного пользования храните skills в $HOME/.agents/skills, для команды — в .agents/skills, а AGENTS.md не путайте со skills, потому что это другой слой инструкций.

Этого уже хватает, чтобы закрыть поисковый запрос “установка скиллов в Codex” не теорией, а рабочей настройкой.

Первоисточники

OpenAI Codex Skills docs · OpenAI AGENTS.md guide · openai/skills on GitHub