Skip to content
cccskills
FreePublished on GitHub

session-save

Save an unfinished session as a timestamped Markdown handoff. Capture changed files, decisions and their reasons, current progress, blockers, and ordered next steps so work can resume later or continue in another Claude instance.

OriginalShow the original description

Save the current session state (decisions, modified files, current status, and next steps) to a handoff file for later resume.

See how to install

Good for

  • Saving unfinished work before ending a session
  • Preserving progress before switching tasks
  • Recording decisions before context compaction
  • Handing work over to another Claude instance

Files included (1)

  • SKILL.md3.5 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

/session-save

Capture the current session into a structured handoff file so you (or another instance) can resume with full context. Creates a timestamped Markdown file in .claude/sessions/.

When to use

  • Before ending a session that isn't complete
  • Before switching to a different task
  • Before context reaches 75%+ (to preserve the important parts)
  • At natural milestones in a long task (after each phase)
  • To hand off to a second Claude instance

Instructions

Produce a handoff document with the following structure:


Session handoff: [TIMESTAMP]

What was being done

[One paragraph: the goal, the approach, where things stand right now]

Files modified this session

[List every file that was created, edited, or deleted, with the nature of the change]

path/to/file.ts      - [what changed and why]
path/to/other.ts     - [what changed and why]

Key decisions made

[Architectural choices, tradeoffs accepted, approaches rejected and why]

  • Decision: [What was decided]
    • Rationale: [Why]
    • Alternatives rejected: [What else was considered]

Current status

[Where things are right now: what's working, what's broken, what's in-progress]

  • Working: [...]
  • In-progress: [...]
  • Known issues: [...]

Next steps (ordered)

[The exact next actions to take to continue, specific enough that a fresh context can pick up without re-reading everything]

  1. [First action]: path/to/file.ts - [what to do]
  2. [...]

Context to reload

[Files that must be read to resume with full understanding, keep this list short]

  • path/to/key-file.ts: [why it matters]
  • CLAUDE.md: project rules

Blockers / open questions

[Anything unresolved that needs a decision or external input before proceeding]

  • [Question or blocker]: [who/what can resolve it]

Implementation

Save the handoff to .claude/sessions/handoff-[YYYY-MM-DD-HHMM].md. Then output the file path so the user knows where to find it.

Resume pattern

To resume from a handoff:

/session-resume .claude/sessions/handoff-YYYY-MM-DD-HHMM.md

Or manually: read the handoff file, then read the files listed in "Context to Reload" before continuing.

Examples

Example 1: Mid-Feature save

/session-save

Claude captures:

  • Auth middleware was being refactored (files: src/middleware/auth.ts, src/middleware/jwt.ts)
  • Decision: switched from session tokens to JWTs (rationale: scales better across services)
  • Status: JWT validation working, refresh logic in-progress
  • Next: implement refreshToken() in src/services/auth.service.ts, then update tests

Example 2: Context-Pressure save

When context hits 70%, run /session-save before /compact to preserve decision context that compaction might lose.

Notes

  • Keep "Context to Reload" to 5 files max. The goal is a fast resume, not a full re-read.
  • "Next Steps" should be specific enough that a cold-start Claude can execute step 1 without asking questions
  • Don't save tool output or code snippets in the handoff; reference file paths instead.

See also:

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Evaluate Claude Code agents, skills, and commands with weighted quality criteria. Get scores, readiness grades, template comparisons, and practical improvement suggestions in Markdown or JSON reports to guide reviews before release.

  • Review skills before release
  • Compare agent definitions with reference templates
  • Quickly check critical quality criteria
FlorianBruniaux/claude-code-ultimate-guide6.2KUpdated Oct 20, 2026

audit-codebase

FreeSummary

Assess a codebase across seven areas, including exposed credentials, security, dependencies, structure, and tests. Receive category scores, findings tied to file locations, and a prioritized improvement plan with smaller tasks that can be completed quickly.

  • Assessing the overall health of an inherited project
  • Reviewing exposed credentials and security risks
  • Identifying dependency and test coverage gaps
FlorianBruniaux/claude-code-ultimate-guide6.2KUpdated Oct 20, 2026

autoresearch

FreeSummary

Measure code patterns such as casts to any or disabled lint rules, then run repeated, targeted edits. Keep changes that improve the chosen metric, revert unsuccessful changes, and track results for each improvement loop.

  • Finding code patterns to prioritize for cleanup
  • Preparing measurement files for an improvement loop
  • Repeating targeted edits to reduce casts to any
FlorianBruniaux/claude-code-ultimate-guide6.2KUpdated Oct 20, 2026

best-of-n

FreeSummary

Generate several separate solutions, compare them against criteria fixed in advance, and verify the selected result through executable checks or an independent reviewer. Keep a proof log documenting candidates, evidence, failures, and remaining limits.

  • Comparing implementation options before choosing one
  • Verifying a solution when a wrong choice would be costly
  • Keeping evaluation evidence for delivery or audit
FlorianBruniaux/claude-code-ultimate-guide6.2KUpdated Oct 20, 2026

canary

FreeSummary

Monitor a live application after deployment and compare it with a saved baseline, a record of its earlier state. Check page responses, loading times, and new errors, flag persistent changes, and produce a per-page health report.

  • Recording a healthy baseline before deployment
  • Monitoring production immediately after deployment
  • Checking key pages for slower responses or failures
FlorianBruniaux/claude-code-ultimate-guide6.2KUpdated Oct 20, 2026

catchup

FreeSummary

Rebuild project context after clearing a conversation or returning to work. Review recent Git history, uncommitted changes, and TODO markers to get a structured summary of project status and suggested next steps.

  • Restoring project context after /clear
  • Reviewing recent changes after a long break
  • Checking unfinished work before choosing the next task
FlorianBruniaux/claude-code-ultimate-guide6.2KUpdated Oct 20, 2026

See all skills by FlorianBruniaux

Report a problem with this skill