Best use case
session-handoff is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
세션 종료 시 plan/INDEX/메모리/저널을 업데이트하고 다음 세션 재개 프롬프트 제공
Teams using session-handoff should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/session-handoff/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How session-handoff Compares
| Feature / Agent | session-handoff | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
세션 종료 시 plan/INDEX/메모리/저널을 업데이트하고 다음 세션 재개 프롬프트 제공
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# Session Handoff 세션에서 수행한 작업 내역을 plan, INDEX, 메모리, 저널에 반영하고, 다음 세션에서 즉시 재개할 수 있는 프롬프트를 제공한다. ## Goal 세션 종료 시 모든 진행 상태를 영속화하여, 다음 세션에서 컨텍스트 손실 없이 작업을 이어갈 수 있도록 한다. ## Steps ### 1. 세션 컨텍스트 수집 대화 내역을 분석하여 다음을 파악한다: - 이번 세션에서 완료한 작업 목록 - 수정/생성한 파일들 - 사용자의 피드백이나 교정 사항 - 다음에 해야 할 작업 **Success criteria**: 완료 항목, 변경 파일, 피드백, 다음 작업이 명확히 정리됨. ### 2. Plan 문서 체크박스 업데이트 - `docs/superpowers/plans/` 또는 프로젝트의 plan 문서에서 완료된 step의 `- [ ]`를 `- [x]`로 변경 - 관련 plan 문서가 없으면 스킵 **Success criteria**: 완료된 모든 step이 `[x]`로 표시됨. Plan이 없으면 스킵했음을 명시. ### 3. 세션 INDEX.md 업데이트 - `.claude/plans/` 하위의 활성 폴더에서 `INDEX.md`를 찾아 업데이트: - `Resume Point`: 다음 세션에서 즉시 작업을 재개할 수 있을 만큼 구체적으로 기술 - `Progress`: 완료 항목 `[x]` 체크, 다음 작업 항목에 `← 다음` 표시 - Global INDEX.md (`.claude/plans/INDEX.md`)도 상태 업데이트 - INDEX가 없으면 스킵 **Success criteria**: Resume Point가 다음 세션에서 바로 시작할 수 있을 만큼 구체적. Progress가 최신 상태. ### 4. 프로젝트 메모리 업데이트 - 기존 프로젝트 메모리 파일을 읽고 현재 상태로 업데이트 (날짜, 완료 항목, 다음 작업) - MEMORY.md 인덱스도 함께 업데이트 - 프로젝트 메모리가 없으면 세션 작업이 충분히 중요한 경우에만 새로 생성 **Success criteria**: 프로젝트 메모리가 현재 상태를 정확히 반영. ### 5. 피드백 메모리 저장 (조건부) - 세션 중 사용자가 교정하거나 피드백을 준 내용이 있으면 feedback 타입 메모리로 저장 - 규칙 + **Why** + **How to apply** 구조로 작성 - 피드백이 없었으면 스킵 **Success criteria**: 사용자 교정 사항이 향후 세션에서 반복되지 않도록 기록됨. 없으면 스킵. ### 6. 저널 기록 - `~/.claude/journals/YYYY-MM.journal.md`에 세션 엔트리 append - 형식: `## YYYY-MM-DD HH:MM | [project] | [context]` + 2-10줄 요약 - bash `printf >>` 로 append (동시성 안전) **Rules**: - 반드시 시스템 시계 기준 타임스탬프 사용 - 기존 엔트리 수정 금지, append only **Success criteria**: 저널에 세션 기록이 추가됨. ### 7. 다음 세션 재개 프롬프트 안내 사용자에게 다음 세션에서 복사해서 사용할 수 있는 구체적인 프롬프트를 제시한다: - 프로젝트 이름 - 어떤 작업을 이어서 할지 - 참고할 문서나 컨텍스트 ``` [프로젝트]에서 [다음 작업]을 시작하자. [참고 문서/컨텍스트]를 참고해서 [구체적 방법]으로 진행해줘. ``` **Success criteria**: 사용자가 다음 세션에서 이 프롬프트만 입력하면 바로 작업을 이어갈 수 있음.
Related Skills
find-session
자연어로 이전 Claude Code 세션을 검색하고 요약하는 스킬. agf 키워드 검색과 qmd 의미 검색을 병행하여 정확도를 높이고, git 커밋 조사와 AI 요약까지 제공한다. "세션 찾아줘", "지난번 작업 찾기", "이전에 했던 ~~ 세션", "~~ 작업한 세션 보여줘", "세션 검색", "작업 이력", "resume session", "이전 대화 찾기", "그때 세션", "그 세션" 등의 요청 시 반드시 이 스킬을 사용할 것. /agf나 qmd-search를 직접 호출하기 전에 이 스킬을 먼저 고려할 것.
analyzing-mlflow-session
Analyzes an MLflow session — a sequence of traces from a multi-turn chat conversation or interaction. Use when the user asks to debug a chat conversation, review session or chat history, find where a multi-turn chat went wrong, or analyze patterns across turns. Triggers on "analyze this session", "what happened in this conversation", "debug session", "review chat history", "where did this chat go wrong", "session traces", "analyze chat", "debug this chat".
weekly-newsletter
Obsidian vault에서 이번 주(토~금) 작성/수정된 글들을 모아 뉴스레터 생성. 서브 에이전트 기반 병렬 처리로 메인 컨텍스트 절약. 기술적, 리더십적으로 외부에 공유할 만한 내용을 선별하여 정리. "뉴스레터 만들어줘", "이번 주 글 정리해줘", "weekly digest" 등의 요청 시 자동 적용.
vis
Vault Intelligence System (vis) CLI를 활용한 Obsidian vault 시맨틱 검색, 자동 태깅, MOC 생성, 관련 문서 연결, 주제별 문서 연결, 주제 수집, 태그 통계, 지식 공백 분석, 중복 감지, 학습 리뷰 등 vault 지식 관리 전반을 지원하는 skill. vault 검색, 문서 정리, 태그, MOC, 관련 문서, 주제 수집, 중복 검사, 학습 리뷰, 지식 공백, 클러스터링, 인덱싱, 주제별 문서 연결, 태그 통계 관련 작업 시 자동 적용.
spark-python-data-source
Build custom Python data sources for Apache Spark using the PySpark DataSource API — batch and streaming readers/writers for external systems. Use this skill whenever someone wants to connect Spark to an external system (database, API, message queue, custom protocol), build a Spark connector or plugin in Python, implement a DataSourceReader or DataSourceWriter, pull data from or push data to a system via Spark, or work with the PySpark DataSource API in any way. Even if they just say "read from X in Spark" or "write DataFrame to Y" and there's no native connector, this skill applies.
searching-mlflow-docs
Searches and retrieves MLflow documentation from the official docs site. Use when the user asks about MLflow features, APIs, integrations (LangGraph, LangChain, OpenAI, etc.), tracing, tracking, or requests to look up MLflow documentation. Triggers on "how do I use MLflow with X", "find MLflow docs for Y", "MLflow API for Z".
retrieving-mlflow-traces
Retrieves MLflow traces using CLI or Python API. Use when the user asks to get a trace by ID, find traces, filter traces by status/tags/metadata/execution time, query traces, or debug failed traces. Triggers on "get trace", "search traces", "find failed traces", "filter traces by", "traces slower than", "query MLflow traces".
recall
Load context from vault memory. Temporal queries (yesterday, last week, session history) use agf (history.jsonl) for fast session lookup. Topic queries use vis semantic search. "recall graph" generates interactive temporal graph of sessions and files. Every recall ends with "One Thing" - the single highest-leverage next action synthesized from results. Use when user says "recall", "what did we work on", "load context about", "remember when we", "prime context", "yesterday", "what was I doing", "last week", "session history", "recall graph", "session graph".
vercel-react-best-practices
React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React/Next.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements.
querying-mlflow-metrics
Fetches aggregated trace metrics (token usage, latency, trace counts, quality evaluations) from MLflow tracking servers. Triggers on requests to show metrics, analyze token usage, view LLM costs, check usage trends, or query trace statistics.
prompt-contracts
프롬프트 작성, brainstorming, planning, design, 설계, 기능 개발 시 Prompt Contracts 프레임워크 적용. Goal/Constraints/Format/Failure Conditions 4요소로 명확한 명세 작성. "바이브 코딩" 방지. brainstorming, writing-plans, 설계, 기능 구현 관련 작업 시 자동 적용.
obsidian-vault
Obsidian vault 및 마크다운 문서 작업 시 사용. markdown-oxide LSP를 통한 효율적인 검색, 백링크 탐색, 태그 관리 지원. vault 경로, 태그 체계, vault-intelligence CLI, 토큰 최적화 전략 제공. Obsidian, vault, 마크다운, 태그, 노트 정리, zettelkasten, 백링크, wiki-link, PKM 관련 작업 시 자동 적용.