session

Manages session continuity by writing, reading, and checkpointing per-project handoff files.

Updated May 3, 2026
One-click install
npx skills add https://github.com/Claudfather/clauDNA --skill session-claudfather
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session
Source: https://github.com/Claudfather/clauDNA/tree/main/skills/session
Command: npx skills add https://github.com/Claudfather/clauDNA --skill session-claudfather

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Losing context between work sessions forces you to reconstruct what you were doing, which branch mattered, and what comes next. This Skill maintains a per-project handoff file so a new session can resume exactly where the last one stopped. ## Core Features & Use Cases - Resume mode: Reads the handoff file, prunes stale items, scans live git state (branches, PRs, stashes), and presents a briefing with a suggested focus at session start. - Handoff mode: Captures activity, decisions, open questions, and next steps at session end, regenerates git state, and writes the file atomically. - Checkpoint mode: Appends new items mid-session without the full handoff ceremony, useful before risky work or compaction. - Name mode: Generates a descriptive session label (DESCRIPTION - REPO#PR - BRANCH) for discovery in /resume. - Use Case: At the end of a day of debugging, run the handoff mode to record decisions and next steps; the next morning, resume mode briefs you on open PRs and where to pick up in under 30 seconds. ## Quick Start Ask the assistant to run the session skill in handoff mode to save the current session state before wrapping up.

Frequently Asked Questions about session

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

FAQPage Schema
How do I save session context before ending a Claude Code session?

Run the session skill in handoff mode. It captures activity, decisions, open questions, and next steps from the conversation, regenerates git state, and writes everything atomically to .claude/session.md in your project directory.

How do I resume work from a previous session?

Run the session skill in resume mode at the start of a new session. It reads the handoff file, prunes stale items, scans live git state including open PRs and stashes, and presents a briefing with a suggested focus in under 30 seconds.

What is the difference between checkpoint and handoff modes?

Checkpoint appends new items mid-session without reaping, full git scans, or user approval, making it a fast save before risky work. Handoff is the end-of-session ceremony that prunes stale items and fully regenerates state.

Where is the session handoff file stored?

The handoff lives at .claude/session.md inside the current working directory, keyed per project. The skill never writes to the global ~/.claude/ config tree, and it manages .gitignore so the file stays out of version control.

Does the session skill work in headless or CI environments?

Yes, the --auto flag makes every mode non-interactive: no questions, silent capture, and a structured JSON result as the final output so orchestrators can confirm the outcome. The name mode is interactive-only and reports blocked under --auto.