session-context-management

Save and resume session progress using /snapshot and /pickup commands.

8|Updated Nov 4, 2025
One-click install
npx skills add https://github.com/ilude/claude-code-config --skill session-context-management
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: session-context-management
Source: https://github.com/ilude/claude-code-config/tree/main/skills/session-context-management
Command: npx skills add https://github.com/ilude/claude-code-config --skill session-context-management

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you maintain "just enough" context across work sessions, especially for non-trivial tasks, preventing loss of progress due to interruptions or context switches. It's designed to be ADHD-friendly and token-efficient, ensuring you can walk away from complex work and return without mental overhead.

Core Features & Use Cases

  • Automated Context Capture: Automatically saves your session state into CURRENT.md, STATUS.md, and LESSONS.md files, providing a clear trail of your work.
  • Seamless Resumption: Offers /snapshot and /pickup commands to save and load your work, allowing you to instantly resume exactly where you left off.
  • Token-Efficient: Focuses on "just enough" documentation to minimize token usage while maximizing utility, keeping your AI focused and responsive.
  • Use Case: You're deep into a complex refactor, but a sudden meeting pops up. Use /snapshot to save your exact mental state and progress, attend the meeting, and then /pickup to instantly resume exactly where you left off, without having to rebuild your mental model.

Quick Start

Activate session context management for the current feature. Then, use the /snapshot command to save your current work state. Later, use the /pickup command to resume.

Frequently Asked Questions about session-context-management

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I avoid losing progress when I switch between tasks or get interrupted?▼

Session context management automatically saves your work state into `CURRENT.md`, `STATUS.md`, and `LESSONS.md` files when tasks run longer than 15 minutes, touch multiple files, or face likely interruptions. Use `/snapshot` to capture your exact mental state and `/pickup` to resume instantly without rebuilding context.

When should I activate session snapshots for my work?▼

Activate session context management when your task will last more than 15 minutes, involves changes to 3+ files, interruptions are likely, or scope may expand. These heuristics trigger automated context capture, preventing loss of progress during context switches and meeting conflicts.

Can I use session snapshots if I work on multiple tasks simultaneously?▼

Yes. Session context management implements multi-instance tagging, allowing you to maintain separate `CURRENT.md`, `STATUS.md`, and `LESSONS.md` snapshots for different work sessions and resume the correct context when you `/pickup` each task.

How does session context management reduce token usage?▼

Session context management focuses on capturing 'just enough' documentation—only essential progress notes, file touches, and lessons learned—rather than verbose logs. This token-efficient approach keeps your AI assistant focused and responsive while maintaining full resumption capability.

What validation happens before session files are written?▼

Session context management performs safety validation before writing to `CURRENT.md`, `STATUS.md`, and `LESSONS.md` files, ensuring snapshots are accurate and preventing corruption of your session state during interruptions or rapid context switches.