role-creator
Create and install custom Codex agent roles with guided configuration and validation.
- 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.jsonbefore reporting success - Provides runnable spawn examples and clear output showing what was configured versus what remains available to inherit
Role Creator
Overview
Use this skill to author, update, or troubleshoot custom Codex agents as standalone TOML files.
Current behavior:
- Each custom agent is defined by one file:
- Global:
~/.codex/agents/<agent-name>.toml - Project:
<project>/.codex/agents/<agent-name>.toml
- Global:
- The agent file is the role source of truth.
~/.codex/config.tomlis only for global/runtime settings (for example[agents]thread limits), not per-role registration.
Non-Negotiable Inputs
Step 1 is required before writing files:
More from am-will/codex-skills
frontend-design
Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.
1.3Kfrontend responsive design standards
Build responsive, mobile-first layouts using fluid containers, flexible units, media queries, and touch-friendly design that works across all screen sizes. Use this skill when creating or modifying UI layouts, responsive grids, breakpoint styles, mobile navigation, or any interface that needs to adapt to different screen sizes. Apply when working with responsive CSS, media queries, viewport settings, flexbox/grid layouts, mobile-first styling, breakpoint definitions (mobile, tablet, desktop), touch target sizing, relative units (rem, em, %), image optimization for different screens, or testing layouts across multiple devices. Use for any task involving multi-device support, responsive design patterns, or adaptive layouts.
1.2Kcontext7
|
1.2Kplanner
>
1.2Kread-github
|
1.2Kparallel-task
>
1.2K