Codex CLI Bridge Skill

Purpose

This skill creates a comprehensive bridge between Claude Code and OpenAI's Codex CLI, enabling seamless interoperability through:

1. Documentation Translation: Converts CLAUDE.md → AGENTS.md (reference-based, no file duplication)
2. Execution Helpers: Python wrappers for Codex CLI commands (always uses codex exec)
3. Skill Documentation: Makes Claude Skills accessible to Codex CLI users

Key Capabilities

1. CLAUDE.md → AGENTS.md Generation

• Parses CLAUDE.md and project structure
• Scans .claude/skills/, .claude/agents/, documentation/ folders
• Generates comprehensive AGENTS.md with file path references
• Reference-based: No file duplication, only links to existing files
• Documents Skills with most relevant usage method (bash scripts vs prompt references)

2. Safety Mechanism

• Auto-checks Codex CLI installation (codex --version)
• Auto-runs /init if CLAUDE.md missing (with user notification)
• Validates authentication and environment
• User-friendly error messages

3. Codex CLI Execution Helpers

• exec_analysis() - Read-only analysis tasks (gpt-5, read-only sandbox)
• exec_edit() - Code editing tasks (gpt-5-codex, workspace-write)
• exec_with_search() - Web search-enabled tasks
• resume_session() - Continue last Codex session
• Always uses codex exec (never plain codex - critical for Claude Code)

4. Skill Documentation for Codex CLI

• Prompt-only skills: Show how to reference in Codex prompts
• Functional skills: Show how to execute Python scripts directly
• Complex skills: Show both methods
• Includes proper codex exec command syntax
• Model selection guidance (gpt-5 vs gpt-5-codex)

Input Requirements