skills.rest
kid-sid
kid-sidCOMMUNITY
Explore all skills by this author →
GitHub

codex-orchestration

Diagnose OpenAI Codex CLI orchestration misconfigurations and debugging challenges.

18|1|Updated Apr 17, 2026
Search Tags:#debugging#hooks#orchestration#codex-cli#agents-md#skill-setup
One-click install
npx skills add https://github.com/kid-sid/codex-spellbook --skill codex-orchestration-kid-sid
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: codex-orchestration
Source: https://github.com/kid-sid/codex-spellbook/tree/main/skills/codex-orchestration
Command: npx skills add https://github.com/kid-sid/codex-spellbook --skill codex-orchestration-kid-sid

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Users struggle with configuring and troubleshooting OpenAI Codex CLI's orchestration features, including skill installation, hook wiring, AGENTS.md precedence, and migration from Claude Code, leading to broken workflows, wasted debugging time, and inconsistent team setups.

Core Features & Use Cases

  • Complete Orchestration Reference: Authoritative documentation for Codex's 6-tier skill discovery paths, hooks.json event schema, stdin payload structure, exit codes, and notify configuration, eliminating the need to search scattered official docs.
  • Cross-Tool Migration Support: Side-by-side comparison of Codex and Claude Code orchestration behaviors, making it easy to migrate existing skills, hooks, and agent configurations between the two tools.
  • Debugging Playbooks: Step-by-step checklists for resolving common issues like implicit skill activation failures, hook non-firing, and AGENTS.md import problems.
  • Use Case Example: A developer setting up a new team Codex environment can use this skill to correctly install shared skills to the .agents/skills/ directory and configure a PreToolUse hook to block dangerous git force-push commands in minutes.

Quick Start

Use the codex-orchestration skill to debug why your custom Codex hook is not triggering when you execute Bash commands in your workflow.

Frequently Asked Questions about codex-orchestration

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

FAQPage Schema
Why is my Codex CLI custom hook not firing when I execute Bash commands?▼

Codex CLI hook non-firing often stems from misconfigured hooks.json event schemas or incorrect stdin payload structures. Debugging playbooks verify exit codes and notify configuration to ensure PreToolUse hooks trigger consistently during workflow execution.

How do I configure AGENTS.md import rules for Codex orchestration?▼

Configuring AGENTS.md import rules requires understanding Codex's specific precedence hierarchy for agent instruction loading. Authoritative references clarify import validation and path resolution to ensure consistent, functional orchestration setups across team environments.

What is the skill path precedence for OpenAI Codex CLI discovery?▼

Codex CLI skill discovery uses a 6-tier path precedence system to locate and activate installed skills. Understanding this hierarchy resolves implicit skill activation failures and ensures correct skill loading from directories like .agents/skills/.

Can I migrate my existing Claude Code hooks and skills to Codex CLI?▼

Migrating Claude Code orchestration to Codex CLI is supported through side-by-side behavioral comparisons of hooks and agent configurations. Cross-tool migration maps equivalent event schemas and skill structures for consistent setups.

How do I block dangerous git force-push commands using a PreToolUse hook in Codex?▼

Blocking git force-push commands uses a PreToolUse hook configured in hooks.json to intercept Bash tool calls. The hook validates stdin payloads and returns specific exit codes to cancel execution before the dangerous command runs.

Related Skills

Explore More Software Engineering Skills→
damadorPLdamadorPL
3

codex-setup

Synchronize BDOS skills into `.agents/skills/` and manage `AGENTS.md` configuration files.

Community
Intermediate
redpanda-dataredpanda-data
34

extend-harness

Manage rule severity and analytics in the frontend-skills hook harness.

Official
Advanced
0xDarkMatter0xDarkMatter
29

claude-code-hooks

Run custom Bash hook scripts for Claude Code tool events.

Community
Intermediate
xotongxotong

V3 Deep Integration

Integrate claude-flow as an adapter-layer extension of agentic-flow@alpha.

Community
Advanced