클로드스킬마트스킬 둘러보기바로 쓰는 문장영상으로 배우기터미널 사용법스킬이 뭐예요?
목록으로

메모리 엔진 (Memory Engine)

Claude Code 세션의 기억을 훅으로 자동 저장·복원하고, 반복 실수까지 학습시키는 메모리 관리 시스템.

유틸리티중급13227AI 점수 9/10마지막 업데이트: 2026. 5. 11.

무엇을 해주나

  • 스마트 컨텍스트: 현재 작업 디렉터리를 감지해 해당 프로젝트의 메모리를 세션 시작 시 자동 로드합니다.
  • 자동 학습(함정 감지): 재시도, 에러 후 수정, 사용자 정정 같은 패턴을 컨텍스트 압축 직전에 잡아내 ~/.claude/skills/learned/에 문제와 해결책을 함께 저장합니다. 같은 실수가 3회 이상 반복되면 영구 규칙으로 승격을 제안합니다.
  • 학생 루프(/reflect): 8단계 학습 사이클(기록 → 연결 → 패턴 탐지 → 리뷰 → 정제 → 재분석 → 정리 → 보고서)로 메모리를 계속 다듬습니다.
  • 세션 핸드오프(/handoff): 진행 상황·결정·미완료 작업을 파일로 남겨 다른 Claude Code 창에서 이어받게 합니다.
  • 교정 사이클(/analyze): 에러 로그에 남지 않는 "사용자가 직접 고친 부분"을 오답 노트로 축적합니다.
  • 저장 시점이 3중(20메시지마다, 압축 직전, 세션 종료)이라 명령어를 잊어도 기록이 남습니다.

이런 분께 추천

  • 긴 작업을 여러 세션에 나눠 진행하다 컨텍스트가 날아가 답답했던 분
  • 여러 프로젝트를 오가며 프로젝트별 규칙과 맥락을 따로 관리하고 싶은 분
  • 여러 기기(회사/집)에서 Claude Code를 쓰며 메모리를 GitHub로 동기화하고 싶은 분
  • Claude가 같은 실수를 반복하는 걸 규칙으로 굳혀서 막고 싶은 분

활용 예시

  1. 작업 도중 컨텍스트가 가득 찼을 때 → /handoff로 진행 상황을 남기고 새 창을 열면 시작 시 자동으로 인수인계 내용을 읽어옵니다.
  2. 한 주간 삽질을 정리하고 싶을 때 → /reflect를 실행해 최근 7일 기록을 리뷰하고, 반복된 실수를 영구 규칙으로 승격시킵니다.
  3. 집 노트북에서 이어 작업할 때 → /sync(memory-backup.sh sync)로 GitHub 백업 저장소와 양방향 동기화한 뒤 /reload로 메모리를 불러옵니다.
  4. MEMORY.md가 비대해졌을 때 → /memory-health로 용량 경고를 확인하고 오래된 내용을 개별 파일로 분리합니다.

· · · 설치 가이드 · · ·

설치 없이 지금 한 번 써보기

아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.

이 파일의 지시를 읽고 그대로 따라서 나를 도와줘:
https://raw.githubusercontent.com/HelloRuru/claude-memory-engine/HEAD/skill/SKILL.md

내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)

Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.

쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.

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

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

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

직접 명령으로 설치하기

git clone https://github.com/HelloRuru/claude-memory-engine.git /tmp/claude-memory-engine && mkdir -p ~/.claude/skills/memory-engine && cp -r /tmp/claude-memory-engine/skill/* ~/.claude/skills/memory-engine/

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

  1. 터미널을 열고 저장소를 클론합니다: git clone https://github.com/HelloRuru/claude-memory-engine.git
  2. 클론한 폴더로 이동합니다: cd claude-memory-engine
  3. 저장소의 README에 설치 스크립트가 있는지 먼저 확인합니다(있다면 그것을 사용하는 편이 가장 안전합니다).
  4. 기존 설정을 백업합니다: cp -r ~/.claude ~/.claude.bak
  5. 스킬을 복사합니다: mkdir -p ~/.claude/skills/memory-engine && cp -r skill/* ~/.claude/skills/memory-engine/
  6. 훅 스크립트와 명령어 파일을 각각 ~/.claude/scripts/hooks/, ~/.claude/commands/로 복사합니다(저장소 내 해당 디렉터리 참고).
  7. ~/.claude/settings.json에 SessionStart, SessionEnd, PreCompact, UserPromptSubmit, PreToolUse 훅을 등록합니다.
  8. 백업 기능을 쓰려면 메모리용 GitHub 저장소를 만들고 memory-backup.sh에 연결한 뒤 memory-backup.sh push로 테스트합니다.
  9. Claude Code를 재시작하고 /overview 또는 /check를 실행해 정상 동작을 확인합니다.