Codex skills: как поставить

Что понадобится

• Установленный Codex CLI. Проверяется командой codex --version.
• Терминал - тот, что уже есть в системе.
• Адрес маркетплейса: локальная папка на диске или репозиторий.

Скиллы в Claude Code разобраны отдельно: что такое скилл. Про сам Codex - в словаре.

Главное, что надо понять до первой команды

Люди ищут «codex skills» и пытаются выполнить codex skills или найти папку ~/.codex/skills. Ни того, ни другого не существует.

В Claude Code скилл - это папка с файлом SKILL.md, положенная в каталог скиллов. Просто и напрямую. В Codex устроено иначе: скиллы едут внутри плагинов.

Смотри сам. Вот что лежит внутри установленного плагина:

плагин/
  README.md
  assets/
  skills/
    documents/
      SKILL.md
      scripts/
      references/

Файл SKILL.md - тот же самый. Меняется только доставка: не «положи папку», а «подключи источник и поставь плагин».

Источник называется маркетплейсом. Это папка или репозиторий, в котором лежит файл .agents/plugins/marketplace.json со списком плагинов и путями к ним:

{
  "name": "мой-маркетплейс",
  "plugins": [
    { "name": "мой-плагин", "source": { "source": "local", "path": "./plugin" } }
  ]
}

Всё остальное - пять команд.

Шаг 1. Проверить версию {#shag-1}

codex --version

Дальше посмотри, есть ли ветка плагинов:

codex --help

В списке команд должна быть строка plugin. Нет - обнови Codex:

codex update

Шаг 2. Посмотреть, что уже подключено {#shag-2}

codex plugin marketplace list

Команда печатает таблицу: имя маркетплейса и путь к нему на диске. Если ты Codex только поставил, там уже будут источники, которые приехали с ним самим.

Шаг 3. Подключить нужный маркетплейс {#shag-3}

codex plugin marketplace add <источник>

В качестве источника команда принимает четыре вида адреса:

• локальный путь к папке - /Users/имя/мои-скиллы;
• пару владелец и репозиторий - owner/repo, можно с веткой через @;
• HTTPS-адрес репозитория;
• SSH-адрес репозитория.

Codex скачивает снимок и добавляет источник в свой список. Повтори шаг 2 - новый маркетплейс должен появиться в таблице.

Шаг 4. Поставить плагин {#shag-4}

Сначала посмотри, что вообще доступно:

codex plugin list

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

codex plugin add ИМЯ@МАРКЕТПЛЕЙС

Можно и без @, тогда маркетплейс указывается отдельно:

codex plugin add ИМЯ --marketplace МАРКЕТПЛЕЙС

Шаг 5. Проверить, что скилл на месте {#shag-5}

codex plugin list

У плагина должно появиться два слова: installed, enabled - и путь на диске. Загляни по этому пути: внутри должна быть папка skills, а в ней папка скилла с файлом SKILL.md.

Увидел SKILL.md - скилл доедет до агента. Не увидел - плагин поставился, но скиллов внутри него нет, и это нормально: плагины бывают и без скиллов, с одними хуками.

Куда смотреть, если что-то не так

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

Повтори ту же структуру у себя в папке:

мои-скиллы/
  .agents/plugins/marketplace.json
  plugin/
    skills/
      мой-скилл/
        SKILL.md

В marketplace.json опиши один плагин с "source": { "source": "local", "path": "./plugin" }. Дальше подключи папку как маркетплейс:

codex plugin marketplace add /путь/к/мои-скиллы
codex plugin add мой-плагин@мой-маркетплейс

Тот же приём работает и для команды: положи папку в репозиторий, и подключаться она будет по owner/repo.

Четыре ошибки, на которых спотыкаются

1. Искать команду codex skills. Её нет и не было. Всё живёт в codex plugin.
2. Создавать ~/.codex/skills руками. Codex эту папку не читает - она ничего не даст.
3. Ставить плагин до подключения маркетплейса. Codex ищет только среди подключённых источников.
4. Путать имя плагина с именем скилла. Ставится плагин; скилл внутри может называться иначе.

Что дальше

• Что такое скилл - если термин пока не оформился.
• Что такое Codex - чем он отличается от Claude Code.
• Каталог скиллов - что можно поставить себе.

Всё, что я собрал для своих проектов, лежит в ClaudeBase: файлы добавляются в проект по инструкции, и агент читает их в рабочем контексте.