Session Kit

A composable set of Claude Code skills for managing session lifecycle — from starting work, through the session, to parking it and finding it later.

Why

Claude Code sessions are ephemeral. When you close a session, the context is gone. Session Kit gives you a lightweight system for:

• Priming repos with expert skills and context files for productive sessions
• Parking sessions with structured artifacts (summary, resume context, prompt analysis)
• Resuming sessions with zero re-explanation
• Finding past work across projects via a searchable index
• Sharing results with teammates in multiple formats (quick summary, full write-up, investigation package)

Install

git clone https://github.com/jstoobz/session-kit.git
cd session-kit
./link.sh

This symlinks each skill into ~/.claude/skills/. Restart Claude Code to pick them up.

Skills

Core Artifacts — generate session documents

Command	Output	Purpose
/tldr	.stoobz/TLDR.md	Concise session summary — key findings, decisions, changes
/relay	.stoobz/CONTEXT_FOR_NEXT_SESSION.md	Everything needed to resume in a new session
/hone	.stoobz/HONE.md	Original prompt + analysis + optimized version
/retro	.stoobz/RETRO.md	Session retrospective — what went well, what to improve
/handoff	.stoobz/HANDOFF.md	Teammate-facing write-up with full business context
/rca	.stoobz/INVESTIGATION_SUMMARY.md + .stoobz/evidence/	Root cause analysis package for engineer + Claude consumption

Lifecycle — manage session flow

Command	Purpose
/park	End session — generate artifacts, archive, update manifest
/park <label>	Park with explicit archive label (e.g., /park PROJ-1234)
/pickup	Start session — load prior context, present briefing
/persist <name> <tags>	Save a reference artifact mid-session to .stoobz/
/index	Find past sessions from manifest
/index --deep <term>	Search inside archived artifact content

Project Setup — create permanent expert knowledge

Command	Purpose
/prime	Analyze repo, create expert skills + context files
/prime --refresh	Update stale skills based on what changed

Maintenance

Command	Purpose
/sweep	Interactive cleanup of old Claude Code sessions from the resume picker
/park --archive-system	Retroactive cleanup of scattered .stoobz/ directories

Archive Structure

Session Kit archives to a central location (default ~/.stoobz/):

~/.stoobz/
├── manifest.json                          ← searchable index for /index
└── sessions/
    ├── my-project/
    │   ├── 2026-02-13-PROJ-1234/          ← /park session archive
    │   │   ├── TLDR.md
    │   │   ├── HONE.md
    │   │   └── RETRO.md
    │   └── auth-flow-notes.md             ← /persist reference artifact
    └── another-project/
        └── 2026-01-28-rate-limiting/
            ├── TLDR.md
            └── INVESTIGATION_SUMMARY.md

All artifacts are written to ./.stoobz/ during a session. /park archives them to ~/.stoobz/sessions/ and leaves only .stoobz/CONTEXT_FOR_NEXT_SESSION.md as the relay baton for /pickup.

Configuration

Variable	Default	Purpose
SESSION_KIT_ROOT	~/.stoobz	Root directory for archives and manifest

Set SESSION_KIT_ROOT to change where archives are stored:

export SESSION_KIT_ROOT="$HOME/.sessions"

Quick Reference

I want to...	Use
Set up expert skills for a new repo	/prime
Update stale expert skills	/prime --refresh
Save everything before stepping away	/park
Resume where I left off	/pickup
Share a quick summary	/tldr
Write up findings for the team	/handoff
Save context for next session	/relay
Improve my prompting	/hone
Reflect on my process	/retro
Package an investigation	/rca
Find a past session	/index
Save a reference mid-session	/persist
Search inside archived content	/index --deep <term>
Clean up old sessions	/sweep

See guide.md for detailed workflows and composability patterns.