session-kit

Synthesize context from selected chain nodes into a focused starting point. Use when the user says "/checkpoint", "synthesize these sessions", "branch from chain", "cherry-pick sessions", or wants to combine findings from specific past sessions while leaving dead ends behind. Reads archived artifacts from selected chain nodes, synthesizes a focused context, and writes a relay baton that starts a new branch chain. The pruned context becomes a clean starting point.

Bootstrap a repository with expert skills and context files for productive Claude sessions. Analyzes codebase architecture, proposes domain-specific expert roles, creates SKILL.md files with references, and wires up feature/debug context loaders. Use when starting in a new repo ("/prime", "bootstrap this repo", "set up expert skills"), when skills are stale ("/prime --refresh"), or when the user wants to create expert roles for a codebase they'll work in repeatedly.

Park the current session by generating all session artifacts, archiving them to $SESSION_KIT_ROOT/sessions/<project>/<date-label>/ (default ~/.stoobz/), and updating the manifest. Use when the user says "/park", "park this session", "wrap up", "I'm done for now", "save everything", or wants to create a complete handoff package before leaving a session. Runs /tldr, /relay, and /hone in sequence, then archives. Supports --archive-system for retroactive cleanup of scattered .stoobz/ directories (with --select, --all, --dry-run, --clean flags).

Register the current Claude Code session under Session Kit and pre-allocate the durable archive + ledger that other session-kit skills depend on. Use when the user says "/checkin", "register this session", "set up session kit here", "start a session", or starts working in a scratch / unfilled cwd and wants explicit Session Kit affordances before any artifact-writing skill fires. Also invoked silently as a precondition by every other artifact-producing session-kit skill (tldr, relay, hone, retro, handoff, rca, persist, park, pickup, checkpoint, prime).

Generate a HANDOFF.md for sharing investigation results or session context with teammates who weren't involved. Use when the user says "/handoff", "share this with the team", "write up for others", "teammate summary", or needs to create documentation for someone unfamiliar with the session. Unlike /tldr (quick scan) or /relay (Claude-to-Claude), this is human-to-human communication with full context.

Capture the session's initial user prompt, analyze its effectiveness, and generate an optimized version. Use when the user says "/hone", "hone my prompt", "capture my prompt", "optimize my prompt", or wants to save and improve the prompt that kicked off the session. Produces HONE.md with the original prompt, analysis, and a refined version for reuse and learning.

Scan $SESSION_KIT_ROOT/manifest.json (default ~/.stoobz/) for session artifacts and build a searchable index of past work. Use when the user says "/index", "find that session", "list my sessions", "what did I work on", "where was that investigation", or needs to locate a past session by topic or ticket. Supports filtering by tag, project, summary, label, or branch. Use --deep to search inside artifact content. Falls back to filesystem scan if no manifest exists.

Save a specific artifact from the current conversation to $SESSION_KIT_ROOT/sessions/ (default ~/.stoobz/) for future discovery via /index. Use when the user says "/persist", "save this", "keep this", "persist this", "stash this for later", or wants to capture a reference artifact (table, runbook, research doc, architecture notes, comparison, plan) without ending the session. The in-flight companion to /park.

Generate investigation artifacts for handing off a root cause analysis to a teammate. Produces INVESTIGATION_SUMMARY.md (human quick-scan), INVESTIGATION_CONTEXT.md (Claude-droppable deep context), and an evidence/ directory with raw artifacts. Use when the user says "/rca", "root cause analysis", "investigation handoff", "share findings", or needs to package debugging results for another engineer to review with their own Claude session. Unlike /handoff (human-to-human), /rca is optimized for engineer + Claude consumption with full evidence preservation.

Generate a CONTEXT_FOR_NEXT_SESSION.md that captures everything needed to resume work in a new Claude Code session without re-explaining. Use when the user says "/relay", "save context", "context for next session", "I need to pick this up later", or wants to preserve session state for continuation. Produces a structured handoff document optimized for pasting into a new session. Like a relay race — passing the baton to the next session.

Run a session retrospective analyzing what went well, what took longer than expected, and what to do differently next time. Use when the user says "/retro", "retrospective", "what went wrong", "session review", or wants to reflect on process and effectiveness after a session. Produces RETRO.md with honest assessment and actionable improvements.

Generate a concise TLDR.md summary of the current session's key findings, decisions, and outcomes. Use when the user says "/tldr", "write a tldr", "summarize this session", "create a summary", or wants a shareable document capturing what happened in this conversation. Produces a clean, engineer-friendly markdown file ready to share before diving into full analysis.

Resume a session by loading prior context from artifacts. Use when the user says "/pickup", "pick up where I left off", "resume", "load context", or starts a new session in a directory that has CONTEXT_FOR_NEXT_SESSION.md or TLDR.md files. Reads existing session artifacts and primes Claude with full context so the user doesn't have to re-explain anything.

Interactive cleanup of old Claude Code sessions from the resume picker. Use when the user says "/sweep", "sweep sessions", "too many sessions", "session picker is cluttered", or wants to remove old/unused sessions. Runs an interactive Python script that categorizes and selectively deletes sessions.