agents-to-claude-mdlisted

# agents-to-claude-md Global, project-agnostic skill. It finds every `AGENTS.md` in the current repo, identifies directories that have no matching `CLAUDE.md`, translates each source file using the Codex → Claude 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 Codex-first repo in Claude Code and there are zero or few `CLAUDE.md` files; the existing `AGENTS.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 AGENTS.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 in a separate list — they will be reported but not translated (no `CLAUDE.override.md` equivalent exists in Claude Code). ### 2. Compute the gap For each `<dir>/AGENTS.md` found, check whether `<dir>/CLAUDE.md` already exists. Separate results into three buckets: - **Gaps** — directory has `AGENTS.md` but no `CLAUDE.md` (action candidates) - **Already in sync** — both files exist (skip silently) - **Override-only** — directory has only `AGENTS.override.md`, no `AGENTS.md` (skip with note) If there are no gaps, report "All directories with AGENTS.md already have a CLAUDE.md — nothing to do." and stop. Present the gap list before doing