session-resume
Resume context from previous session
When & Why to Use This Skill
The Session Resume skill is a specialized context-recovery tool for Claude agents, designed to eliminate startup friction between work sessions. By systematically analyzing active todos, development plans, recent git activity, and system health, it enables the agent to reconstruct a comprehensive mental model of the project state, ensuring seamless continuity and improved workflow efficiency.
Use Cases
- Project Continuity: Automatically retrieving pending tasks and active plans at the start of a new session to ensure no work is overlooked.
- Technical Context Recovery: Analyzing recent git logs and uncommitted changes to understand the specific code modifications made in previous sessions.
- Workflow Alignment: Generating a structured 'Session Context' summary that aligns both the agent and the user on the current progress and the most logical next steps.
- Environment Readiness Checks: Verifying system health and dashboard metrics before resuming development to ensure a stable working environment.
| name | session-resume |
|---|---|
| description | Resume context from previous session |
Session Resume Skill
Helps agents quickly understand where work left off when starting a new session.
When To Use
- At the start of any new conversation
- When context seems missing
- When user asks "what were we working on?"
Instrumentation
# Log usage when using this skill
./scripts/log-skill.sh "session-resume" "manual" "$$"
Quick Resume Checklist
1. Check Active Work
# Ready todos (highest priority)
ls todos/*-ready-*.md 2>/dev/null | head -5
# In-progress plans
ls plans/*.md 2>/dev/null
# Recent solutions (for context)
ls -t docs/solutions/**/*.md 2>/dev/null | head -3
2. Check Recent Git Activity
# Recent commits
git log --oneline -5
# Uncommitted changes
git status --short
3. Summarize Context
After gathering info, summarize:
4. Check System Health
./scripts/compound-dashboard.sh
Review health grade and recommendations before starting work.
5. Final Summary
📍 Session Context:
**Active Work:**
- {X} ready todos waiting
- Plan in progress: {plan name if any}
**Recent Activity:**
- Last commit: {subject}
- {Changed files if uncommitted}
**Suggested Next Steps:**
1. {Most logical next action}
2. {Alternative}
Automatic Triggers
Consider running this skill when you see:
- User starts with "continue", "resume", "where were we"
- First message in a new session
- User seems to lack context
References
- Todos:
todos/ - Plans:
plans/ - Solutions:
docs/solutions/ - Workflows:
.agent/workflows/