codex-cli-specialist — Claude Code skill: setup and features
codex-cli-specialist — a skill for Claude Code and Codex ports skills to OpenAI Codex format, validates dual-platform rules, and outputs registry manifests. Runs when syncing shared skill libraries across coding assistants.
LicenseRef-MIT-Commons-Clause 132 installs ★ 1,183 updated 2026-11-08
npx skills add borghei/Claude-Skills --skill codex-cli-specialist -a claude-codeWhat codex-cli-specialist does
The setup includes three distinct Python tools: codex_skill_converter.py parses frontmatter from SKILL.md to produce agents/openai.yaml, cross_platform_validator.py applies up to 21 compatibility checks, and skills_index_builder.py produces a skills-index.json registry file.
The converter intentionally omits the model parameter in agents/openai.yaml, so the skill relies on the user's default Codex CLI model instead of breaking on deprecated model IDs. Running the workflows requires a local Python environment.
What it helps with
- generate agents/openai.yaml configs from Claude Code SKILL.md
- validate cross-platform compliance across 21 checks
- build a skills-index.json file for skill discovery
- replicate scripts, references, and assets into Codex folder structure
Example prompts for the agent
- Convert the skill in skills/code-tour into Codex format
- Run the cross-platform validator on /tmp/code-tour-codex with strict mode
- Generate skills-index.json for this repository
How to install codex-cli-specialist
1Skills CLI (Vercel)
npx skills add borghei/Claude-Skills --skill codex-cli-specialist -a claude-code2Manually: put the files in place
~/.claude/skills/codex-cli-specialist/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/codex-cli-specialist/
1Skills CLI (Vercel)
npx skills add borghei/Claude-Skills --skill codex-cli-specialist -a codex2Manually: put the files in place
.agents/skills/codex-cli-specialist/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add borghei/Claude-Skills --skill codex-cli-specialist -a cursor2Manually: put the files in place
.cursor/skills/codex-cli-specialist/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install borghei/Claude-Skills engineering/codex-cli-specialist/SKILL.md2Manually: put the files in place
.github/skills/codex-cli-specialist/SKILL.md1Skills CLI (Vercel)
npx skills add borghei/Claude-Skills --skill codex-cli-specialist -a gemini-cli2Platform CLI
gemini skills install https://github.com/borghei/Claude-Skills --path engineering/codex-cli-specialistManually: put the files in place
.devin/skills/codex-cli-specialist/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add borghei/Claude-Skills --skill codex-cli-specialist -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about codex-cli-specialist
How to install codex-cli-specialist in Claude Code?
Run npx skills add borghei/Claude-Skills --skill codex-cli-specialist -a claude-code in your terminal.
What does codex-cli-specialist do?
It translates Claude Code skills into OpenAI Codex format, checks structural compliance across both environments, and builds registry index files.
Why does generated openai.yaml leave model unset?
Leaving model unset allows the skill to inherit whatever default model is configured in the local Codex CLI environment.