claude-md-to-agents-mdlisted

# claude-md-to-agents-md Global, project-agnostic skill. It finds every `CLAUDE.md` in the current repo, identifies directories that have no matching `AGENTS.md`, translates each source file using the Claude -> Codex substitution table, and - with per-item approval - writes the draft or invokes `$init` inline for a richer code-derived alternative. Use when: you've opened a Claude-first repo in Codex and there are zero or few `AGENTS.md` files; the existing `CLAUDE.md` files already describe the directory's purpose and conventions, so translation is a near-free win over starting from scratch. ## Procedure ### 1. Scan ```bash find . -name CLAUDE.md \ -not -path '*/node_modules/*' \ -not -path '*/.git/*' \ -not -path '*/vendor/*' \ -not -path '*/.venv/*' ``` Also detect `AGENTS.override.md` files with a parallel find. Keep them as target-side context - they are never translated or overwritten, but they may affect the approval prompt for a directory that is missing shared `AGENTS.md` guidance. ### 2. Compute the gap For each `<dir>/CLAUDE.md` found, check whether `<dir>/AGENTS.md` already exists. Separate results into three buckets: - **Gaps** - directory has `CLAUDE.md` but no `AGENTS.md` (action candidates) - **Override-present gaps** - directory has `CLAUDE.md` and `AGENTS.override.md`, but no `AGENTS.md` (action candidates with an extra warning) - **Already in sync** - both files exist (skip silently) If there are no gaps or override-present gaps, report "