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.yaml and 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.json manifest 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.json for a skill library.
Installs
124
GitHub Stars
439
First Seen
Feb 28, 2026
codex-cli-specialist — borghei/claude-skills