Agent skill · software engineering · borghei
codex-cli-specialist
OpenAI Codex CLI and cross-platform skill authoring. Use when setting up Codex CLI, converting or syncing skills between Claude Code and Codex, configuring agents/openai.yaml, or validating cross-platform skill compatibility.
Why this skill is useful
Adds 3 executable scripts for skill conversion, validation, and index building that extend Codex CLI capabilities.
What it needs
Requires python installed locally. About 3k tokens when loaded. Last updated 2026-07-21. 462 stars on the source repository.
What this skill does
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. Clarify First Before converting or building, confirm these inputs. If any is unknown or vague, ASK — do not assume: [ ] Task — convert a skill, validate cross-platform compatibility, or build a skills index (selects codexskillconverter.py vs crossplatformvalidator.py vs skillsindexbuilder.py) [ ] Source path — the SKILL.md or skill directory to operate on (the input the scripts read) [ ] Strictness — strict validation mode and whether to fail on warnings (sets --strict and the pass/fail gate) Stop rule: ask only the 2-3 that most change the output. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills borghei/codex-cli-specialist