# codex-cli-specialist

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.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 132 installs · ★ 1183 repo stars
- Author: borghei
- License: LicenseRef-MIT-Commons-Clause · policy=link-only · description only; the file stays with the author
- Source: https://github.com/borghei/Claude-Skills/tree/HEAD/engineering/codex-cli-specialist/SKILL.md
- Updated: 2026-11-08
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/codex-cli-specialist

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill codex-cli-specialist -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/codex-cli-specialist/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/codex-cli-specialist/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill codex-cli-specialist -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/codex-cli-specialist/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill codex-cli-specialist -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/codex-cli-specialist/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install borghei/Claude-Skills engineering/codex-cli-specialist/SKILL.md
```

2. **Manually: put the files in place**
- File: `.github/skills/codex-cli-specialist/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill codex-cli-specialist -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/borghei/Claude-Skills --path engineering/codex-cli-specialist
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/codex-cli-specialist/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill codex-cli-specialist -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/borghei/Claude-Skills/tree/HEAD/engineering/codex-cli-specialist/SKILL.md

## When to use it
- 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
- 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

## Similar
- [gpt-image](https://affpapa.org/en/nevibecode/skills/wuyoscar-gpt-image.md) — skill · 613 installs
- [config-codex-cli](https://affpapa.org/en/nevibecode/skills/config-codex-cli.md) — skill · 1300 installs
- [oracle](https://affpapa.org/en/nevibecode/skills/oracle.md) — skill · 5200 installs
- [openai-docs-skill](https://affpapa.org/en/nevibecode/skills/openai-docs-skill.md) — skill · 1200 installs
- [codex-review](https://affpapa.org/en/nevibecode/skills/jezweb-codex-review.md) — skill · 579 installs
- [codex](https://affpapa.org/en/nevibecode/skills/hermes-agent-codex.md) — skill · 445 installs

From the same set: [borghei/claude-skills](https://affpapa.org/en/nevibecode/by/borghei/claude-skills.md) — 120 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
