Files
Conal Mullan 3c3bf68cf9 DOCS: move 'Using with Codex' details to docs/codex.md
The README section had grown to ~55 lines, mostly a hardcoded list of 26
installed skill directories that drifts stale as skills are added (it was
already missing ideogram4). The script discovers skills dynamically from
.claude/skills/, so docs/codex.md now explains the discovery rule instead
of enumerating directories. README keeps a three-line summary: the command,
a link to the doc, and the contributor credit.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-09 23:09:48 +01:00

1.5 KiB

Using with Codex

This toolkit is built around Claude Code assets in .claude/ and CLAUDE.md, but it also ships an experimental migration script for Codex — contributed by @kimhoontae-gogo in #16.

python3 scripts/migrate_to_codex.py --force

This does two things:

  1. Installs Codex skills into ~/.codex/skills — one skill per directory found in .claude/skills/ (domain knowledge: remotion, ltx2, ideogram4, acestep, …) plus the guided workflows from .claude/commands/ (video, brand, voice-clone, …). The set is discovered dynamically, so newly added toolkit skills are picked up on the next run; the script prints exactly what it installed.
  2. Generates a Codex block in the repository root AGENTS.md, derived from CLAUDE.md.

The AGENTS.md block

  • The script manages only its generated block inside AGENTS.md.
  • Manual AGENTS.md content outside that block is preserved.
  • The block is derived from CLAUDE.md — after CLAUDE.md changes, re-run python3 scripts/migrate_to_codex.py --force to refresh it.

Removing

python3 scripts/migrate_to_codex.py --reset

--reset removes the toolkit skills previously installed under ~/.codex/skills and removes the generated Codex block from AGENTS.md. It does not delete other user skills and it does not remove the rest of AGENTS.md.