smart-compact

Save current session state to .claude/session-state.md before clearing.

30|1|Updated Apr 15, 2026
One-click install
npx skills add https://github.com/s-choung/Research-Skills --skill smart-compact-s-choung
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: smart-compact
Source: https://github.com/s-choung/Research-Skills/tree/main/skills/smart-compact
Command: npx skills add https://github.com/s-choung/Research-Skills --skill smart-compact-s-choung

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you preserve the current working session before a reset, so you can quickly recover context after clearing the conversation.

Core Features & Use Cases

  • Session Snapshotting: Writes a compact session-state file into the current project directory.
  • Recovery Support: Captures tone, decisions, files, bugs, and next steps so a new session can resume efficiently.
  • Use Case: If you are about to use /clear in the middle of a long task, this Skill records the essential context needed to continue without starting over.

Quick Start

Use the smart-compact skill to save the current session state in the working directory so I can clear and recover it later.

Frequently Asked Questions about smart-compact

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

FAQPage Schema
How do I preserve Claude session context before clearing the conversation?

To preserve Claude session context before clearing, use a session snapshotting process to write your current tone, decisions, files, and next steps into a recovery file. This captures the essential working state needed to resume efficiently.

What is session state recovery for workflow handoffs?

Session state recovery for workflow handoffs is the process of saving your current decisions, files, and status into a compact file before a reset. This ensures the next session can resume the task without losing prior context.

How do I save my working session to a markdown file before a reset?

You save your working session to a markdown file by writing the current tone, decisions, files, bugs, and next steps into a structured recovery file within your project directory. This creates a snapshot for instant recovery later.

Can I recover Claude session decisions and status after using /clear?

Yes, you can recover Claude session decisions and status after using /clear if you snapshot the session state beforehand. The recovery file captures the necessary context, allowing a new session to resume the work efficiently.

Does session snapshotting work for short, structured handoff workflows?

Session snapshotting is specifically designed for short, structured handoff workflows where context must be preserved. It records the essential working state into a file, ensuring seamless recovery for the next session.

What is the best way to recover context after clearing a long task session?

The best way to recover context after clearing a long task session is to generate a session-state file beforehand. This compact file captures your current tone, decisions, and next steps, allowing you to resume without starting over.