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.