role-creator

Name: role-creator
Availability: InStock
Author: harryriddle

Create and install Codex agent role config files with validation.

3|Updated Mar 22, 2026

Search Tags:#validation #codex #agent #config #installation #role

Ready to run

npx skills add https://github.com/0xharryriddle/codex-field-kit --skill role-creator

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: role-creator
Source: https://github.com/0xharryriddle/codex-field-kit/tree/main/archive/upstream/examples/codex-skills/skills/role-creator
Command: npx skills add https://github.com/0xharryriddle/codex-field-kit --skill role-creator

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, tomlq, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Designing Codex agent roles is error-prone and time-consuming. This Skill standardizes role creation, validation, and installation to ensure consistent configurations across projects.

Core Features & Use Cases

Role scaffolding: generate and install role config files with required keys and guardrails.
Validation and guardrails: enforce supported keys and required inputs to prevent misconfigurations.
Use case: quickly add or update a role for a project, then deploy to global or project config.

Quick Start

Provide a role name, description, and config path, then run the role-creator to generate and install the role.

Frequently Asked Questions about role-creator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I install a custom Codex agent role with configuration validation?▼

To install a custom Codex agent role with configuration validation, provide a role name, description, and config path. The role-creator validates required inputs and writes the config file to ~/.codex/config.toml or a project config.

What are guardrails in Codex agent role configuration?▼

Guardrails in Codex agent role configuration are validation rules that enforce supported keys and required inputs. They prevent misconfigurations by standardizing role creation and ensuring consistency across global or project scopes.

How do I add a restricted profile agent to my Codex project config?▼

You can add a restricted profile agent to your Codex project config by using role templates. The role-creator supports generating minimal or restricted profiles and installs them directly into your project configuration file.

Do I need jq and tomlq to create Codex agent roles?▼

Yes, you need jq and tomlq installed as dependencies to create Codex agent roles. These tools are required by the role-creator scripts to parse and validate the TOML configuration files properly.

Why does my Codex agent role installation fail validation?▼

Codex agent role installation fails validation when required inputs are missing or unsupported keys are present. The role-creator enforces guardrails to prevent these misconfigurations and ensure consistent role definitions.