save-session

Checkpoint an active session's decisions and progress into its registered notes.md without closing it.

6|1|Updated Jun 6, 2026
One-click install
npx skills add https://github.com/t-mercier/ai-agents-orchestrator --skill save-session-t-mercier
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: save-session
Source: https://github.com/t-mercier/ai-agents-orchestrator/tree/main/skills/save-session
Command: npx skills add https://github.com/t-mercier/ai-agents-orchestrator --skill save-session-t-mercier

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Long AI coding sessions lose context to compaction, wiping out decisions made hours earlier. This Skill writes a mid-session checkpoint into the session's registered notes.md so decisions, files touched, and next steps survive compaction while the session stays open. ## Core Features & Use Cases - Session checkpointing: Resolves the active session ID, finds its registered notes.md (with a relink fallback for resumed sessions), and updates Decisions, Files touched, Open questions, and Next steps sections. - Frontmatter refresh: Auto-attaches PR links (via gh CLI and conversation scan) and ticket IDs, recording ticket statuses, without overwriting existing values. - Knowledge distillation and skill proposals: Optionally promotes durable decisions to a knowledge vault and proposes reusable skills, both gated behind configuration flags. - Use Case: Midway through a long refactoring session, run the checkpoint before context compaction so the next conversation resumes with full decisions and a prioritized next-steps queue. ## Quick Start Ask the AI to save the current session checkpoint so the notes file captures decisions and next steps before context compaction.

Frequently Asked Questions about save-session

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

FAQPage Schema
How do I save a Claude Code session without closing it?

Run the /save-session command to checkpoint the active session. It updates the session's notes.md with decisions, files touched, and next steps, then appends an in-progress history entry while keeping the session open.

How to prevent losing context when a Claude session gets compacted?

Checkpoint the session before compaction so key decisions and next steps are persisted to notes.md. The checkpoint writes dated decision entries and a prioritized next-steps queue that the next conversation can resume from.

What is the difference between save-session and close-session?

save-session marks the history entry as in progress and keeps the session running, while close-session writes a close-style entry and wraps the session up. Use save-session mid-session and close-session when the work is done.

Why does save-session fail to find my session notes?

The session may not be registered in active-sessions.json, which happens with resumed sessions. The skill falls back to searching category folders for a notes.md containing the session ID, but unregistered sessions require running start-session or restart-session first.

Does save-session work in plan mode?

No, it stops immediately when plan mode is active because it writes files, which plan mode blocks. Switch to auto mode and re-run the command.