codex-to-claudelisted
Install: claude install-skill ada-ggf25/AI-Tools
# Port Codex artifacts to Claude
Finds Codex skills/agents that have no Claude counterpart in this repo and adapts them
to Claude Code conventions, one item at a time with per-item approval.
## Procedure
### 1. Compute the gap
Run both diffs in parallel:
```bash
# Skills missing from claude/
comm -23 \
<(ls global/codex/skills/ | sort) \
<(ls global/claude/skills/ | sort)
# Agents missing from claude/ (strip .toml extension for comparison)
comm -23 \
<(ls global/codex/agents/ | sed 's/\.toml$//' | sort) \
<(ls global/claude/agents/ | sed 's/\.md$//' | sort)
```
If both lists are empty, report "No gaps found — codex/ and claude/ are in sync" and stop.
### 2. Present the gap list
Show the user two sections:
```text
Skills to port (global/codex/skills/<name>/SKILL.md → global/claude/skills/<name>/SKILL.md)
- <name>
...
Agents to port (global/codex/agents/<name>.toml → global/claude/agents/<name>.md)
- <name>
...
```
Ask which items to port. Do not proceed without explicit approval per item.
### 3. Adapt skills (for each approved skill)
Read `global/codex/skills/<name>/SKILL.md`, then apply these substitutions:
| Find | Replace with |
|---|---|
| `AGENTS.md` / `AGENTS.override.md` | `CLAUDE.md` |
| `$<skill-name>` invocation syntax | `/<skill-name>` |
| `where-agents-md` cross-references | `where-claude` |
| `audit-agent-docs` cross-references | `audit-claude-md` |
| Codex config paths (`~/.codex/`, `$CODEX_HOME`) | Claude config paths (`~/.clau