긴 세션에서는 컨텍스트가 소진됩니다. 새로운 세션에는 이전 기억이 없습니다. 이 공백을 메우는 것이 handoff(인계) 스킬입니다. 해야 할 일은 하나로, 현재 작업 상태를 짧은 문서로 작성하여 다음 에이전트에게 읽히게 하는 것입니다.
카탈로그에서 'handoff'가 이름에 포함된 스킬을 검색하면, 설치 수가 가장 많은 것은 mattpocock/skills의 handoff 스킬로 1,002,999개였습니다(skills.sh 레지스트리, 2026년 10월 15일 기준). 하지만 '가장 많이 설치된 것'과 '자신의 사용 목적에 맞는 것'은 다릅니다. 여기서는 5가지 스킬을 내용으로 비교합니다.
참고로 저희는 Skillselion(실제 설치 수로 에이전트 스킬을 나열하는 독립적인 디렉터리)을 운영하고 있습니다. 숫자는 공개 카탈로그의 것입니다.
먼저 결론부터 말씀드립니다
| 스킬 | 설치 수 | 작성 위치 | 작성 후 동작 |
|---|
| handoff (mattpocock/skills) | 1,002,999 | $TMPDIR, 아니면 /tmp | 작성하고 멈춤 |
| claude-handoff (mattpocock/skills) | 398,692 | 위와 동일(요약 그대로 전달) | 백그라운드 에이전트 시작 |
| session-handoff (softaworks/agent-toolkit) | 4,174 | .claude/handoffs/ | 검증 및 점수 매기기, 재개 시 신선도 판정 |
| handoff (rohitg00/agentmemory) | 13,098 | 작성하지 않음 | agentmemory 서버에서 이전 내용을 호출 |
| paseo-handoff (getpaseo/paseo) | 4,642 | Paseo의 브리핑 자료 | Paseo를 통해 에이전트 생성(worktree는 선택 사항) |
수치는 skills.sh 레지스트리, 2026년 10월 15일 기준입니다.
handoff 문서는 auto-compact와 무엇이 다른가
Claude Code의 자동 컴팩션(auto-compact)은 컨텍스트 상한선에 가까워질 때 같은 세션 내에서 기록을 요약합니다. 반면, handoff 문서는 세션 외부에 파일로 남기 때문에 다른 세션이나 다른 에이전트에서도 읽을 수 있습니다.
mattpocock의 스킬은 자신의 작업을 한 줄로 이렇게 설명하고 있습니다.
Compact the current conversation into a handoff document for another agent to pick up. (현재 대화를 요약하여 다른 에이전트가 가져갈 인계 문서로 만듭니다.)
handoff와 claude-handoff의 차이는 '그 이후'뿐이다
같은 리포지토리에 두 개가 있고, 요약하는 방식은 공통적입니다. 다른 점은 작성이 끝난 후의 동작입니다.
handoff
는 문서를 작성하고 멈춥니다. 저장 위치는 워크스페이스가 아니라 OS의 임시 디렉터리($TMPDIR, 아니면 /tmp (Windows는 %TEMP%))입니다. 다음 세션을 직접 열어 그 파일을 전달해야 합니다.
claude-handoff 스킬(398,692개 설치)은 동일한 요약을 그대로 프롬프트로 사용하여 백그라운드 에이전트를 시작합니다.
claude --bg --name "<설명적인 이름>"
이름을 반드시 지정해야 합니다. 작업 목록과 세션 피커에 나타나는 것이 그 이름이기 때문입니다. 관리는 claude agents로 수행합니다. 현재 사용 중인 세션은 비게 되므로, 조사를 투척하고 자신은 다른 작업으로 돌아가는 방식으로 사용됩니다.
공통 규칙이 4가지 있습니다.
- 다음 에이전트에게 읽히게 하고 싶은 스킬을 'suggested skills' 섹션에서 명시합니다.
- 사양서, 계획, ADR(Architecture Decision Record), issue, 커밋, diff 등은 경로 또는 URL로 참조하며 본문에 복사하지 않습니다. - API 키, 비밀번호, 개인 정보는 가립니다. claude-handoff의 경우 요약이 그대로 프롬프트가 되므로 더욱 중요합니다.
- 인수가 전달되면, 그것을 다음 세션의 초점으로 간주합니다.
자동으로 발동되지는 않는다
둘 다 disable-model-invocation: true입니다.
입니다. 즉, 모델의 판단으로 멋대로 실행되는 것이 아니라 이름을 지정해야 움직일 수 있습니다. '슬슬 인계해 줄 거야'라고 기다리고 있으면 아무 일도 일어나지 않는 것은 대부분 이 이유 때문입니다.
참고로 claude-handoff는 리포지토리의 in-progress 폴더에 위치하며, handoff보다 덜 정착된 취급을 받고 있습니다. 리포지토리 전체 지도는 Matt Pocock 스킬맵에 정리되어 있습니다.
검증과 점수를 추가하고 싶을 경우
softaworks/agent-toolkit의 session-handoff 스킬(4,174 설치)은 더 무거운 구조입니다. Python 스크립트가 .claude/handoffs/에 타임스탬프가 찍힌 파일을 만들고, 브랜치 이름, 최근 커밋, 변경 파일을 포함합니다.
그 후 검증기(validator)가 시크릿의 혼입 여부를 조사하고 품질 점수를 0점에서 100점으로 매깁니다. 이 스킬 자체 설명에 따르면 70점 미만일 경우 확정되지 않도록 되어 있습니다. 재개 시에는 신선도 체크가 실행되며, FRESH부터 VERY_STALE까지 평가됩니다. 인계 자체를 리포지토리에 남겨 히스토리로 하고 싶은 장기 프로젝트용입니다.
인계를 시작할 기준도 이 스킬의 description이 구체적입니다. 컨텍스트가 한계에 가까울 때, 큰 마일스톤을 넘었을 때, 작업 세션 종료 시, 사용자가 'context is getting full'이라고 말했을 때. 또한, 파일 편집이 5건 이상 되었을 때, 복잡한 디버깅을 했을 때, 큰 판단을 내렸을 때는 스킬 측에서 인계를 제안합니다.
'쓰지 않는' handoff도 있다
rohitg00/agentmemory의 handoff 스킬(13,098 설치)은 문서를 쓰지 않습니다. 역방향 작업을 합니다. memory_sessions와 memory_recall을 agentmemory 서버에 호출하여 현재 디렉토리에 연결된 최근 세션을 찾고, 미해결 질문을 맨 앞에 놓습니다. 세션을 넘어서 기억을 갖고 싶다면 영속 메모리 계열 스킬 가이드도 참고하세요.
getpaseo/paseo의 paseo-handoff 스킬(4,642 설치)은 태스크, 파일, 현황, 시도한 것, 수용 조건이라는 섹션으로 브리핑을 구성하고 Paseo를 통해 에이전트를 만듭니다. worktree를 자르는 옵션도 있습니다.
이름은 비슷하지만 용도가 다른 것이 하나 더 있습니다. anthropics/knowledge-work-plugins의 design-handoff는 완성된 디자인을 개발자용 사양으로 내리는 별개의 것입니다. 세션 인계를 찾아서 이것을 넣어도 맞지 않습니다.
첫 번째 스킬과 그 이후
대부분의 경우, 처음에 넣는 것은 mattpocock의 handoff가 좋습니다. 설치 수는 claude-handoff의 약 2.5배이며, 본체는 짧은 단락이 5개뿐이고, 스크립트도 서버도 필요 없습니다 (mattpocock/skills는 GitHub 스타 291,760, MIT 라이선스. GitHub API, 2026년 10월 15일 기준).
npx skills add mattpocock/skills --skill handoff
다음 단계를 그 자리에서 실행하고 싶다면 claude-handoff를, 인계를 리포지토리에 쌓아두고 싶다면 softaworks의 session-handoff를 추가합니다.
자주 막히는 경우 4가지를 말씀드리겠습니다. 계획 본문을 handoff에 복사해 버리는 것(오래되고, 다음 에이전트의 컨텍스트를 차지함. 경로는 참조). 시크릿을 지우는 것을 잊어버리는 것. 자동으로 발화할 거라 생각하고 기다리는 것. 그리고 파일이 리포지토리에 있다고 착각하는 것(임시 디렉토리이므로, 남기고 싶다면 직접 옮겨야 함).
컨텍스트가 가득 차기 전에 작성하고, 짧게 요약하며, 이미 있는 것은 링크로 지칭합니다. 이것만으로도 다음 세션의 시작이 달라집니다.
5가지 비교와 설치 수 내역은 handoff 스킬 비교 가이드에 정리되어 있습니다. 계획/문서 관련 다른 후보는 문서 및 계획 카테고리 추천 스킬, 스킬 구조 전체는 Claude Code 스킬 종합 가이드가 입구입니다.
공개 정보: 저희는 Skillselion을 운영하고 있습니다. 설치 수는 skills.sh, GitHub, MCP 레지스트리에서 매일 업데이트되는 공개 카탈로그 값입니다. Skillselion은 독립적인 프로젝트이며, Anthropic, OpenAI, Cursor와는 관련이 없습니다.
토론
