role-creator

Create and install custom Codex agent roles with guided configuration and validation. Use this skill to author, update, or troubleshoot custom Codex agents as standalone TOML files. Current behavior: Step 1 is required before writing files: Execution rule: From Codex custom agent docs ( /codex/subagents ): nickname_candidates requirements: - Collects required inputs (model, reasoning effort, developer instructions, role name, install scope) before writing any files, with strict validation against the config schema - Writes minimal role config files by default, adding optional parameters like sandboxing, web search controls, and MCP servers only when explicitly requested - Installs roles into global ( ~/.codex/config.toml ) or project-scoped ( .codex/config.toml ) config with automatic backups and additive safety - Validates role declarations and config file keys against codex-rs/core/config.schema.json before reporting success - Provides runnable spawn examples and clear output showing what was configured versus what remains available to inherit - Each custom agent is defined by one file: - Global: ~/.codex/agents/ .toml - Project: /.codex/agents/ .toml - The agent file is the role source of truth. - ~/.codex/config.toml is only for global/runtime settings (for example [agents] thread limits), not per-role registration. - name (role identifier used by agent_type ) -...