skills.rest
0xharryriddle
0xharryriddleCOMMUNITY
Explore all skills by this author →
𝕏@0xHarryNguyenVNGitHub

role-creator

Create and install Codex agent role config files with validation.

3|Updated Mar 22, 2026
Search Tags:#validation#codex#agent#config#installation#role
One-click install
npx skills add https://github.com/0xharryriddle/codex-field-kit --skill role-creator
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
tiweentiween

bmad-customize

Modify TOML configuration overrides for BMad skills and workflows via CLI.

Official
Advanced
julianobarbosajulianobarbosa
7

Iterm2

Manage iTerm2 and tmux workflows with native -CC integration.

Community
Intermediate
growthxaigrowthxai

flow-convert-prompts-to-files

Converts inline, array, and XML prompts to Output SDK .prompt files with YAML frontmatter.

Official
Advanced
AzureAzure
267

azure-role-selector

Identify least-privilege Azure RBAC roles and generate CLI or ARM snippets.

Official
Intermediate