Где Codex ищет скиллы
Формат тот же, что у Claude Code и открытого стандарта Agent Skills: папка, в ней SKILL.md с полями name и description. Отличаются пути.
.agents/skills в текущей папке и в каждой родительской до корня репозиторияПользователь$HOME/.agents/skillsАдминистратор/etc/codex/skillsСистемныевстроены в Codex, их поставляет OpenAIСтарый путь ~/.codex/skills в текущей документации не упоминается. Его по-прежнему читает Cursor ради совместимости, но для Codex кладите скиллы в .agents/skills. Тот же путь читают Cursor, Copilot, Gemini CLI, OpenCode и Zed, так что одна папка обслуживает сразу несколько агентов.
Установка через $skill-installer
Внутри сессии Codex есть встроенный скилл-установщик. Пишете в чат:
$skill-installer linear
Он ставит курированные скиллы и умеет брать их из других репозиториев. Codex замечает новые скиллы сам. Если скилл не появился в списке, перезапустите Codex: так советует официальная документация.
Установка через npx skills add
Универсальный установщик vercel-labs/skills знает Codex под идентификатором codex:
npx skills add OWNER/REPO -a codex npx skills add OWNER/REPO --skill имя-скилла -a codex -g
Без -g скилл ляжет в .agents/skills/ проекта, с -g в ~/.agents/skills/. Нужен Node.js 22.20 или новее. Тот же скилл одной командой ставится и в Claude Code (-a claude-code), это удобно, когда в команде работают на разных агентах.
Чужой скилл ставьте после того, как прочитали SKILL.md и скрипты в папке. Скилл исполняется с правами агента, а GitHub в документации по скиллам прямо предупреждает: их никто не проверяет, и внутри может оказаться промпт-инъекция. Особенно внимательно смотрите на всё, что ходит в сеть или читает файлы вне проекта.
Как вызвать скилл в Codex
- Явно. В CLI или расширении IDE наберите
/skillsили напишите$и имя скилла. - Неявно. Codex сам выбирает скилл, если задача совпадает с его description.
В контексте сначала лежит только список скиллов. На него отведено не больше 2 % контекстного окна, а если размер окна неизвестен, 8 000 символов. Настройка skills.max_context_tokens поднимает потолок до 10 000 токенов. Когда места не хватает, Codex укорачивает описания, и скилл с длинным description может перестать срабатывать сам.
Рядом со SKILL.md можно положить agents/openai.yaml: там метаданные для интерфейса, зависимости инструментов и политика policy.allow_implicit_invocation, которая запрещает или разрешает неявный вызов.
openai/skills устарел: что вместо него
Репозиторий openai/skills (28 281 звезда на 24.10.2026, 44 файла SKILL.md: 39 курированных и 5 системных) в README объявлен устаревшим. Замена — openai/plugins. Старые скиллы оттуда по-прежнему читаются, но новых там ждать не стоит.
У части скиллов из openai/skills лицензия не свободная: восемь распространяются по Figma Developer Terms, четыре принадлежат Notion. Перед тем как копировать их в свой репозиторий, откройте LICENSE.txt в папке скилла.
Плагины Codex собирают скиллы, MCP-серверы и хуки в один пакет. В CLI их ищут командой /plugins: она открывает каталог плагинов из подключённых маркетплейсов. После установки начните новую сессию, иначе скиллы плагина не подхватятся.
Custom prompts больше не нужны
Раньше повторяемые запросы в Codex хранили как custom prompts в ~/.codex/prompts/*.md и вызывали через /prompts:имя. Документация пометила их устаревшими и советует переносить в скиллы. Перенос простой: файл промпта становится телом SKILL.md, к нему добавляется frontmatter с name и description.
Где брать скиллы, проверенные по лицензии и описанию, смотрите в подборке скиллов для Codex. Если выбираете между агентами, есть разбор Claude Code или Codex.
