skills.rest
racecraft-lab
racecraft-labOFFICIAL
Explore all skills by this author →
GitHub

install

Copy Codex subagent TOML templates into the user's Codex agents directory.

3|1|Updated Mar 24, 2026
Search Tags:#automation#codex#subagents#plugin#toml#install#codex-agents
One-click install
npx skills add https://github.com/racecraft-lab/racecraft-plugins-public --skill install-racecraft-lab
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: install
Source: https://github.com/racecraft-lab/racecraft-plugins-public/tree/main/speckit-pro/codex-skills/install
Command: npx skills add https://github.com/racecraft-lab/racecraft-plugins-public --skill install-racecraft-lab

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, rsync, perl, and includes scripts (resource) components.

What problem does it solve?

Installs or refreshes the bundled SpecKit Pro Codex subagents by copying the TOML templates into the user's Codex agents directory and validating the installation, then prompts a restart to load the new subagents.

Core Features & Use Cases

  • Copies all bundled Codex subagent TOML templates from codex-agents into ~/.codex/agents/ by default, or a user-specified directory when overridden.
  • Validates the presence of required templates and applies compatibility rewrites for gpt-5.4 if needed, then provides a clear post-install summary.
  • Use Case: Deploy SpecKit Pro Codex subagents across machines and ensure they load after a Codex restart.

Quick Start

Install the bundled Codex subagents into your Codex agents directory and restart Codex when prompted.

Frequently Asked Questions about install

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

FAQPage Schema
How do I install Codex subagents into my agents directory?▼

To install Codex subagents, this tool copies bundled TOML templates from codex-agents into ~/.codex/agents, validates required files, applies gpt-5.4 compatibility rewrites, and prompts a restart to load the new subagents.

Can I specify a custom directory when installing Codex subagent TOML templates?▼

Yes, you can install Codex subagent TOML templates into a custom directory. The tool operates within the default path ~/.codex/agents unless overridden by a user-specified destination path during the copy process.

Do I need jq and rsync to set up Codex subagents?▼

Yes, you need jq, rsync, and perl installed. These dependencies are required to copy TOML templates, validate the presence of required subagent files, and apply compatibility rewrites for gpt-5.4.

What happens if my Codex subagent templates need gpt-5.4 compatibility rewrites?▼

When gpt-5.4 compatibility is needed, the installation process automatically applies rewrites to the TOML templates. It then prints a post-install summary detailing the source, destination, and model policy used.

Why are my newly installed Codex subagents not loading?▼

Newly installed Codex subagents may not load because Codex requires a restart. After copying and validating the TOML templates, the tool explicitly prompts a restart to ensure the new subagents are properly loaded.

Related Skills

Explore More Software Engineering Skills→
greenheadHQgreenheadHQ
4

configuring-codex

Configure Codex CLI settings and verify AGENTS.md skill projection.

Community
Advanced
alexandremendoncaalvaroalexandremendoncaalvaro
1

ad-subagent

Generate compliant Codex subagent TOML configuration files.

Community
Intermediate
huyhung9630huyhung9630
1

omc-agents

Route tasks to specialized agent roles within the Codex system.

Community
Advanced
PsychQuantPsychQuant

codex-docs-guide

Query OpenAI Codex CLI source code and documentation for configuration and usage details.

Official
Intermediate