session-management

Automate Claude Code session checkpoints with YAML frontmatter and MCP-safe state.

1|Updated Dec 24, 2025
One-click install
npx skills add https://github.com/davidmoneil/AIfred --skill session-management-davidmoneil
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: session-management
Source: https://github.com/davidmoneil/AIfred/tree/main/.claude/skills/session-management
Command: npx skills add https://github.com/davidmoneil/AIfred --skill session-management-davidmoneil

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents context loss across Claude Code sessions by providing a unified workflow for starting, tracking, checkpointing, and ending sessions with consistent documentation.

Core Features & Use Cases

  • Automatic session initialization: loads session-state.md and current-priorities.md at session start.
  • Cross-project continuity: preserves institutional knowledge across projects and orchestrations.
  • Checkpointing and proper exit: enables On-Demand MCP restart safety and structured handoffs with documented procedures.

Quick Start

Start a new Claude Code session and observe the skill auto-load context. Review the loaded session-state.md and current-priorities.md, then begin by setting a short-term goal and running a checkpoint when preparing to move to another task.

Frequently Asked Questions about session-management

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

FAQPage Schema
How do I preserve context across Claude Code sessions?▼

To preserve context across Claude Code sessions, this Skill automates session management by loading session-state.md and current-priorities.md at start, enabling checkpointing, and documenting structured handoffs to prevent context loss.

What is the best way to checkpoint a Claude Code session before switching projects?▼

The best way to checkpoint a Claude Code session is using the Skill's manual commands to update priorities and trigger MCP-safe checkpoints, ensuring structured handoffs and context preservation before moving to another task or project.

Does session management for Claude Code work across multiple projects?▼

Yes, session management for Claude Code works across multi-project environments, preserving institutional knowledge and orchestration context by maintaining consistent session state and priority documentation throughout.

How does automatic session initialization load context in Claude Code?▼

Automatic session initialization loads context by implementing hooks that read session-state.md and current-priorities.md at session start, immediately restoring your previous priorities and institutional knowledge without manual intervention.

Can I use YAML frontmatter in SKILL.md for Claude Code session state?▼

Yes, you can use YAML frontmatter in SKILL.md to define session management configurations, with optional assets available for reference materials to support context preservation and checkpointing procedures.

When should I avoid relying on automatic context preservation in Claude Code?▼

You should avoid relying solely on automatic context preservation when preparing for MCP restarts; instead, trigger manual checkpoint commands to ensure safe handoffs and documented session exits before switching tasks.