codex-cli-specialist
Installation
SKILL.md
Codex CLI Specialist
The agent converts Claude Code skills to Codex-compatible format, validates cross-platform compatibility, and builds skill registry manifests. It generates agents/openai.yaml configurations from SKILL.md frontmatter, runs 17 compatibility checks across both platforms, and produces skills-index.json for discovery systems.
Core Capabilities
- Skill conversion — turn a Claude Code SKILL.md into a Codex-compatible skill by generating
agents/openai.yamland copying scripts/references/assets. - Cross-platform validation — run 17 checks across Claude Code, Codex CLI, and shared categories (frontmatter, openai.yaml, encoding, naming, size).
- Index building — scan skill directories and emit a
skills-index.jsonmanifest for registries, discovery, and version pinning. - Codex CLI setup & operation — install, configure API access, and run with the right approval mode (suggest / auto-edit / full-auto).
- Dual-target authoring — write skills that work on both platforms from one shared
scripts/,references/,assets/tree. - Distribution & sync — keep Claude Code and Codex in sync via shared repo, CI/CD conversion, or git hooks; publish via GitHub releases.
When to Use
- Setting up or operating OpenAI Codex CLI.
- Converting or syncing skills between Claude Code and Codex.
- Configuring or reviewing
agents/openai.yaml. - Validating a skill for dual-platform compatibility.
- Building a
skills-index.jsonfor a skill library.