role-creator — скилл для Claude Code: что делает и как установить
Генерирует и обновляет конфигурации субагентов Codex в отдельных TOML-файлах. Пригодится, когда нужно настроить кастомную роль с чёткими инструкциями и моделью.
npx skills add am-will/codex-skills --skill role-creator -a claude-codeЧто делает role-creator
Скилл помогает создавать и править файлы ролей для Codex без ручного заполнения TOML. Каждая роль хранится отдельно: либо глобально в ~/.codex/agents/<имя>.toml, либо локально внутри каталога <project>/.codex/agents/<имя>.toml. Общий файл config.toml при этом не затрагивается, потому что он отвечает только за системные параметры окружения.
Перед созданием файла скилл требует явно задать имя роли, её модель, инструкции для разработчика и уровень рассуждений. Ассистент не станет додумывать обязательные значения за пользователя, поэтому без прямого подтверждения параметров запись на диск не начнётся. Скрипт write_role_config.sh также умеет добавлять список имён для отображения, настраивать доступ к песочнице и сетевой поиск.
После генерации TOML проверяется через утилиту tomlq, чтобы исключить синтаксические ошибки. Если при вызове роли окружение выдаёт unknown agent_type, первым делом стоит проверить путь к файлу конфигурации и совпадение области видимости.
Какие задачи решает
- сгенерировать отдельный TOML-файл субагента Codex
- задать модель и системные инструкции для новой роли
- настроить локальную роль агента внутри конкретного проекта
- проверить синтаксис готового конфига агента через tomlq
Примеры запросов агенту
- Создай глобального субагента reviewer для проверки пулреквестов с моделью gpt-5.4
- Настрой проектную роль security-auditor в .codex/agents с высоким уровнем рассуждений
- Добавь в конфигурацию агента список псевдонимов и отключи поиск в сети
Как установить role-creator
1Через Skills CLI (Vercel)
npx skills add am-will/codex-skills --skill role-creator -a claude-code2Вручную: положить файлы
~/.claude/skills/role-creator/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/role-creator/
1Через Skills CLI (Vercel)
npx skills add am-will/codex-skills --skill role-creator -a codex2Вручную: положить файлы
.agents/skills/role-creator/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add am-will/codex-skills --skill role-creator -a cursor2Вручную: положить файлы
.cursor/skills/role-creator/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install am-will/codex-skills role-creator2Вручную: положить файлы
.github/skills/role-creator/SKILL.md1Через Skills CLI (Vercel)
npx skills add am-will/codex-skills --skill role-creator -a gemini-cli2Командой платформы
gemini skills install https://github.com/am-will/codex-skills --path skills/role-creatorВручную: положить файлы
.devin/skills/role-creator/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add am-will/codex-skills --skill role-creator -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о role-creator
Как установить role-creator в Claude Code?
Выполните команду npx skills add am-will/codex-skills --skill role-creator -a claude-code. Конфигурация появится в ~/.claude/skills/role-creator/SKILL.md.
Что делает скилл role-creator?
Он формирует и проверяет standalone-файлы конфигурации TOML для субагентов Codex. Скилл собирает обязательные поля, форматирует параметры и выдаёт готовый JSON-вызов для запуска роли.
Где сохраняются созданные роли Codex?
В зависимости от выбранной области видимости файл записывается либо глобально в ~/.codex/agents/<agent-name>.toml, либо в каталог конкретного репозитория <project>/.codex/agents/<agent-name>.toml.
