클로드스킬마트스킬 둘러보기스킬이 뭐예요?
 
← 목록으로

Claude 메모리 → 도구 중립 문서 마이그레이션

Claude Code에만 갇힌 개인 memory를 Codex·Cursor 같은 다른 AI 도구도 읽는 공용 문서 구조로 옮겨줍니다.

유틸리티고급★ 1,323⑂ 212AI 점수 8/10마지막 업데이트: 2026. 8. 8.

무엇을 해주나

Claude Code의 개인 memory(~/.claude/projects/<slug>/memory/)는 버전 관리되지 않고 다른 도구는 전혀 읽지 못합니다. 이 스킬은 그 안에서 도구 간 공유 가치가 있는 내용(사용자 프로필, 협업 취향, 작업 방법론)만 골라 ~/.claude/references/user/로 옮기고, 다음 2층 구조를 세팅합니다.

  • 무조건 읽히는 층: 꼭 지켜야 할 3~6개 핵심 사실을 ~/.claude/CLAUDE.md 상단에 인라인
  • 필요할 때 읽는 층: 상세 프로필·사례는 references/ 파일로 분리하고 포인터만 남김
  • Codex 배선: ~/.codex/AGENTS.md → ~/.claude/CLAUDE.md 심볼릭 링크 + 32KiB 문서 잘림을 막는 project_doc_max_bytes 조정

총 6단계(진단·분류 → 마이그레이션 → 병렬 리뷰 4종 → 수정 → 실제 codex 실행으로 검증 → memory 정리·소프트 삭제)를 체크리스트로 진행합니다.

이런 분께 추천

  • Claude Code와 Codex(또는 Cursor)를 같은 프로젝트에서 번갈아 쓰는데, 다른 도구는 "내가 누군지" 모르는 분
  • memory가 팀 규칙·SOP·임시 인수인계 메모까지 뒤섞여 비대해진 분
  • 개인 설정을 특정 도구에 종속시키지 않고 문서로 관리하고 싶은 분

활용 예시

  1. "내 memory를 도구 중립 문서로 옮겨줘" → 각 memory 파일을 팀 문서 / 사용자 프로필 / 그대로 유지 3분류로 정리하고, 프로필만 references로 이관.
  2. "Codex가 내 프로필을 못 읽어" → 심볼릭 링크와 config를 배선한 뒤 codex exec를 실제로 돌려 세션 로그에서 인라인 섹션이 주입됐는지 grep으로 증명.
  3. "CLAUDE.md가 너무 길어서 뒷부분이 무시되는 것 같아" → 32KiB 잘림 여부를 확인하고 project_doc_max_bytes를 올려 뒤쪽 문자열까지 로드되는지 검증.

· · · 설치 가이드 · · ·

Claude 앱에 설치 (터미널 필요 없음)
  1. 아래 버튼으로 ZIP 파일을 받으세요.
  2. Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
  3. Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
↓ ZIP 내려받기
Claude Code에 설치

Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 daymade/claude-code-skills 의 daymade-claude-code/claude-migrate-memory-to-doc 폴더를 내 ~/.claude/skills/claude-migrate-memory-to-doc/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.

직접 명령으로 설치하기

git clone https://github.com/daymade/claude-code-skills.git && mkdir -p ~/.claude/skills && cp -r claude-code-skills/daymade-claude-code/claude-migrate-memory-to-doc ~/.claude/skills/

⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.

  1. 터미널을 엽니다.
  2. 스킬 폴더가 없다면 만듭니다: mkdir -p ~/.claude/skills
  3. 저장소를 내려받습니다: git clone https://github.com/daymade/claude-code-skills.git
  4. 스킬을 복사합니다: cp -r claude-code-skills/daymade-claude-code/claude-migrate-memory-to-doc ~/.claude/skills/
  5. 안전을 위해 미리 백업합니다: cp ~/.claude/CLAUDE.md ~/.claude/CLAUDE.md.bak (파일이 있을 때)
  6. Claude Code를 재시작하고 /skills 또는 "내 memory를 도구 중립 문서로 마이그레이션해줘"라고 요청합니다.
  7. Codex 연동까지 원하면 codex가 설치돼 있어야 합니다(command -v codex로 확인). 없으면 문서 이관까지만 수행됩니다.
  8. 작업이 끝나면 안내대로 .memory-archive-YYYY-MM-DD 백업 폴더를 1~2주 유지한 뒤 삭제하세요.
GitHub에서 원본 보기 ↗라이선스: MIT