Claude-skill-registry codex-agent-collaboration
Delegate coding tasks to Codex AI for implementation, analysis, and alternative solutions. Use when you need a second AI perspective, want to explore different approaches, or need specialized Codex capabilities for complex coding tasks.
git clone https://github.com/majiayu000/claude-skill-registry
T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/codex-agent-collaboration" ~/.claude/skills/majiayu000-claude-skill-registry-codex-agent-collaboration && rm -rf "$T"
skills/data/codex-agent-collaboration/SKILL.mdCodex CLI Skill
This skill enables Claude Code to execute tasks using OpenAI's Codex AI agent.
Overview
The
codex-kkp-cli is a Codex Agent CLI tool, allowing you to:
- Execute coding tasks and get implementations
- Perform code analysis and reviews
- Get alternative solutions and suggestions
- Collaborate with Codex for cross-checking implementations
Usage
Basic Syntax
# Direct call with platform-specific executable executables/codex-kkp-cli-{platform} --cd=/absolute/path/to/project [options] "<task_description>"
Where
{platform} is one of:
- macOS Intel (x86_64)macosx64
- macOS Apple Silicon (ARM64)macosarm64
- Linux x86_64linuxx64
- Linux ARM64linuxarm64
- Windows x86_64mingwx64
Platform Auto-Detection Helper: A platform detection script is provided to help identify your current platform:
On Windows, Just use mingwx64 platform directly, no need to use script detection.
# Unix/Linux/macOS codex-kkp-cli-platform # Outputs: macosx64, macosarm64, linuxx64, or linuxarm64
communication
This is AI-to-AI communication between You and Codex. PRIORITIZE ACCURACY AND PRECISION over human readability. Use structured data, exact technical terms, full paths, and precise details. NO conversational formatting needed.
Required Parameters
| Parameter | Description |
|---|---|
| Task | The task description (positional argument, must be quoted) |
| Working directory (ABSOLUTE PATH REQUIRED) |
Optional Parameters
| Parameter | Description |
|---|---|
| Session ID (STRONGLY RECOMMENDED for follow-up chats to maintain context) |
| Sandbox mode. Default is . See sandbox-modes.md |
| Allow Codex to edit files automatically |
| Include an image file (ABSOLUTE PATH, can repeat) |
| Skip Git repository check. Default is . Use to enable Git check |
For output options (
--full, --output-last-message, --output-schema), see outputs.md.
NOTE that parameters and values are connected by an EQUAL SIGN
=, not a space.
Response Format
Returns JSON with
"type": "SUCCESS" or "type": "ERROR".
{ "type": "SUCCESS", "session": "xxxxxxx", "content": { "agentMessages": "I've analyzed the code and found...", "fileChanges": [...], // Optional "nonFatalErrors": [...] // Optional } }
andfileChanges
is nullable.nonFatalErrors- Error responses do NOT include a
field.session
Quick Example
New Session:
executables/codex-kkp-cli-{platform} --cd=/path/to/project "Explain the main function in Main.kt"
Continue Previous Session:
executables/codex-kkp-cli-{platform} --cd=/path/to/project --session=xxxxxxx "Explain the main function in Main.kt"
More examples: examples.md