# role-creator

Генерирует и обновляет конфигурации субагентов Codex в отдельных TOML-файлах. Пригодится, когда нужно настроить кастомную роль с чёткими инструкциями и моделью.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1200 установок · ★ 1039
- Автор: am-will
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/am-will/codex-skills/tree/HEAD/skills/role-creator/SKILL.md
- Обновлён: 2026-07-14
- HTML: https://affpapa.org/nevibecode/skills/role-creator

## Что делает

Скилл помогает создавать и править файлы ролей для Codex без ручного заполнения TOML. Каждая роль хранится отдельно: либо глобально в `~/.codex/agents/<имя>.toml`, либо локально внутри каталога `<project>/.codex/agents/<имя>.toml`. Общий файл `config.toml` при этом не затрагивается, потому что он отвечает только за системные параметры окружения.

Перед созданием файла скилл требует явно задать имя роли, её модель, инструкции для разработчика и уровень рассуждений. Ассистент не станет додумывать обязательные значения за пользователя, поэтому без прямого подтверждения параметров запись на диск не начнётся. Скрипт `write_role_config.sh` также умеет добавлять список имён для отображения, настраивать доступ к песочнице и сетевой поиск.

После генерации TOML проверяется через утилиту `tomlq`, чтобы исключить синтаксические ошибки. Если при вызове роли окружение выдаёт `unknown agent_type`, первым делом стоит проверить путь к файлу конфигурации и совпадение области видимости.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add am-will/codex-skills --skill role-creator -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/role-creator/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/role-creator/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add am-will/codex-skills --skill role-creator -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/role-creator/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add am-will/codex-skills --skill role-creator -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/role-creator/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install am-will/codex-skills role-creator
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/role-creator/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add am-will/codex-skills --skill role-creator -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/am-will/codex-skills --path skills/role-creator
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/role-creator/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add am-will/codex-skills --skill role-creator -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/am-will/codex-skills/tree/HEAD/skills/role-creator/SKILL.md

## Когда брать
- сгенерировать отдельный TOML-файл субагента Codex
- задать модель и системные инструкции для новой роли
- настроить локальную роль агента внутри конкретного проекта
- проверить синтаксис готового конфига агента через tomlq

## Примеры запросов агенту
- Создай глобального субагента reviewer для проверки пулреквестов с моделью gpt-5.4
- Настрой проектную роль security-auditor в .codex/agents с высоким уровнем рассуждений
- Добавь в конфигурацию агента список псевдонимов и отключи поиск в сети

## Похожие
- [bmad-customize](https://affpapa.org/nevibecode/skills/bmad-customize.md) — скилл · 11200 установок
- [azure-role-selector](https://affpapa.org/nevibecode/skills/azure-role-selector.md) — скилл · 9399 установок
- [Post-Implementation Audit Agent Role](https://affpapa.org/nevibecode/prompts/post-implementation-audit-agent-role.md) — промпт · ★ 174597
- [skill-creator](https://affpapa.org/nevibecode/skills/starchild-ai-agent-skill-creator.md) — скилл · 7800 установок
- [semgrep-rule-variant-creator](https://affpapa.org/nevibecode/skills/semgrep-rule-variant-creator.md) — скилл · 5300 установок
- [prd-creator](https://affpapa.org/nevibecode/skills/prd-creator.md) — скилл · 5100 установок

Из того же набора: [am-will/codex-skills](https://affpapa.org/nevibecode/by/am-will/codex-skills.md) — 10 карточек

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md