Codex To Claude

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:

# Skills missing from claude/
comm -23 \
  /SKILL.md → global/claude/skills//SKILL.md)
  - 
  ...

Agents to port   (global/codex/agents/.toml → global/claude/agents/.md)
  - 
  ...

Ask which items to port. Do not proceed without explicit approval per item.

3. Adapt skills (for each approved skill)

Read global/codex/skills//SKILL.md, then apply these substitutions:

| Find | Replace with | |---|---| | AGENTS.md / AGENTS.override.md | CLAUDE.md | | $ invocation syntax | / | | where-agents-md cross-references | where-claude | | audit-agent-docs cross-references | audit-claude-md | | Codex config paths (~/.codex/, $CODEX_HOME) | Claude config paths (~/.claude/) | | "Codex" when referring to the product/tool | "Claude Code" | | "AGENTS" when used as a generic concept for instruction files | "CLAUDE.md" |

Show the adapted content to the user and ask for approval before writing.

Write to global/claude/skills//SKILL.md only after approval.

4. Adapt agents (for each approved agent)

Read global/codex/agents/.toml. Extract:

• name — use as-is (convert underscores to hyphens for kebab-case)
• description — use as-is
• developer_instructions — becomes the Markdown body
• sandbox_mode = "read-only" → explicit tools list (Read, Glob, Grep; add WebSearch/WebFetch only if the instructions reference web access)
• model_reasoning_effort = "medium" → model: haiku; "high" → omit (default Sonnet)

Write global/claude/agents/.md in this shape:

---
name: 
description: 
tools:
  - Read
  - Glob
  - Grep
---

Flag the output as needing human review before writing — TOML → Markdown is a lossy transformation and the instructions may contain Codex-specific concepts.

5. Run install.sh

After all approved writes:

./install.sh

Report which symlinks were created.

6. Wrap up

Tell the user:

• Which items were ported (with their destination paths)
• Which items were skipped and why
• Remind them to restart Claude Code for new /commands to appear in autocomplete

Guardrails

• Never overwrite an existing file in global/claude/ — skip with a warning if the target already exists.
• Never modify any file under codex/ — it is read-only source for this skill.
• Always show the adapted content and get per-item approval before writing.
• TOML agent → Markdown is inherently lossy: flag it explicitly; do not claim the conversion is complete.
• Names that differ between products (e.g., where-agents-md vs where-claude) must be noted — do not silently rename without telling the user.
• Do not run ./install.sh until at least one file has been written.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: ada-ggf25
• Source: ada-ggf25/AI-Tools
• License: MIT

Install and usage instructions live in the source repository linked above.