Migrate Claude Memory to Tool-Agnostic Docs
Moves Claude Code's per-project memory into tool-agnostic reference docs so Codex (and other AI CLIs) can read your profile, then verifies it by actually running codex.
What it does
Claude Code's personal memory (~/.claude/projects/<slug>/memory/) is locked to one tool — run Codex or Cursor in the same directory and they have no idea who you are. This skill classifies every memory file by scope, migrates only the cross-tool-shareable part into ~/.claude/references/user/, and inlines the 3–6 must-always-load facts directly into the CLAUDE.md body (because plain-text pointers are on-demand and Codex never follows them). It then wires ~/.codex/AGENTS.md → ~/.claude/CLAUDE.md, raises project_doc_max_bytes to defeat Codex's silent 32 KiB doc truncation, runs 4 parallel review subagents, verifies empirically by running codex and grepping the session log, and finally cleans memory with dated soft-delete archives outside memory/.
Who it's for
- Developers alternating between Claude Code and Codex/Cursor in the same repo
- Anyone whose user profile and collaboration preferences are trapped in one tool
- Anyone with bloated memory who needs to separate team SOPs from legitimate handoff state
- Anyone worried about leaking PII / real-name maps into version-controlled docs
Examples
- "Migrate my memory" → every memory file classified as migrate / thin / keep, only shareable content moved.
- "Codex doesn't know how to address me" → hardcore facts inlined at the top of CLAUDE.md, symlink wired, then
codex exec --skip-git-repo-checkplus a session-id log grep proves injection. - "My CLAUDE.md is over 32 KiB" →
project_doc_max_bytesraised and a back-of-file string grepped to confirm the second half actually loads.
· · · Install guide · · ·
Try it now, no install
Paste this into Claude to use the skill without installing anything.
Read the instructions in this file and follow them to help me: https://raw.githubusercontent.com/daymade/claude-code-skills/HEAD/daymade-claude-code/claude-migrate-memory-to-doc/SKILL.md What I want: (describe your task here)
If Claude can't open the link, open it yourself and paste the contents instead.
↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the daymade-claude-code/claude-migrate-memory-to-doc folder from the GitHub repo daymade/claude-code-skills into my ~/.claude/skills/claude-migrate-memory-to-doc/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/daymade/claude-code-skills.git /tmp/daymade-skills && mkdir -p ~/.claude/skills && cp -r /tmp/daymade-skills/daymade-claude-code/claude-migrate-memory-to-doc ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Open a terminal.
- Clone the repo:
git clone https://github.com/daymade/claude-code-skills.git /tmp/daymade-skills - Ensure the skills dir exists:
mkdir -p ~/.claude/skills - Copy the skill:
cp -r /tmp/daymade-skills/daymade-claude-code/claude-migrate-memory-to-doc ~/.claude/skills/ - Confirm the bundled
references/files came along:ls ~/.claude/skills/claude-migrate-memory-to-doc - Back up your global config first:
cp ~/.claude/CLAUDE.md ~/.claude/CLAUDE.md.bak - Restart Claude Code and ask: "migrate my memory to tool-agnostic docs".
- For the Codex wiring and Phase 5 verification, make sure codex is installed (
command -v codex).