skills.rest
Kotomiya07
Kotomiya07COMMUNITY
Explore all skills by this author →
GitHub

compact-plus

Saves structured recovery checkpoints before Claude Code context compaction.

Updated Jul 16, 2026
Search Tags:#context management#claude code#handoff#checkpoint#session recovery#compaction#redaction
One-click install
npx skills add https://github.com/Kotomiya07/skills --skill compact-plus-kotomiya07
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: compact-plus
Source: https://github.com/Kotomiya07/skills/tree/main/plugins/compact-plus/skills/compact-plus
Command: npx skills add https://github.com/Kotomiya07/skills --skill compact-plus-kotomiya07

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Long Claude Code sessions lose critical working context when /compact runs, forcing you to reconstruct goals, decisions, Git state, and next steps from scratch. This Skill captures a structured, redacted checkpoint before compaction and can export an emergency handoff when same-session recovery is no longer reliable. ## Core Features & Use Cases - Structured Pre-Compact Checkpoints: Writes a fixed-format recovery file covering goals, authoritative documents, decisions, rejected hypotheses, Git/PR state, loop state, workers, and the next deterministic action. - Secret Redaction and Size Limits: Enforces redaction of tokens, credentials, and personal data, and keeps checkpoint files under 64 KiB. - Emergency Handoff Export: Generates a sanitized handoff file via checkpoint.py when repeated compaction has made the current session unreliable. - Use Case: Before running /compact in a long debugging session, invoke the skill to save the current branch, failing test hypothesis, and next command so the post-compaction session resumes deterministically. ## Quick Start Ask Claude to run compact-plus to save a recovery checkpoint before compacting this session.

Frequently Asked Questions about compact-plus

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

FAQPage Schema
How do I save Claude Code session state before /compact?▼

Invoke the compact-plus skill before running /compact. It detects the session id, gathers goal, plan, Git, and task state, writes a fixed-format checkpoint to the temp directory, and hardens it with the checkpoint.py precompact command.

What is an emergency handoff in Claude Code compaction?▼

An emergency handoff is a sanitized export created with checkpoint.py prepare-handoff when repeated compaction makes the current session unreliable. A user or supervisor must start a successor session, load the handoff, and revalidate Git, issue, and CI state.

Does compact-plus store secrets or credentials in checkpoints?▼

No. The skill mandates redaction of tokens, authorization and cookie values, passwords, private keys, URL credentials, and personal email addresses before writing, and caps checkpoint files at 64 KiB.

Can a compact-plus checkpoint authorize commits or pushes?▼

No. Checkpoints and handoffs never broaden approval scope. They do not authorize commits, pushes, pull requests, merges, destructive actions, or external messages; those still require explicit user approval.

When should I use handoff instead of a normal checkpoint?▼

Use handoff only after same-session checkpoint recovery proves inadequate due to repeated compaction, contradictory state, or clear context drift. Always complete and verify the standard checkpoint procedure first.

Related Skills

Explore More Software Engineering Skills→
BrandondaymdrBrandondaymdr
1

session-checkpoint

Commit work-in-progress changes to a version-controlled branch with structured metadata.

Community
Intermediate
thecomputer07thecomputer07

qsd-resume

Load the latest qsd checkpoint and reconstruct STATE.md, ROADMAP.md, and PLAN.md.

Community
Advanced
watminwatmin

curare

Prune stale entries and replace the current-state note at wrap-ups.

Community
Intermediate
hideki5123hideki5123
2

session-handover

Install PreCompact and SessionStart hooks to generate and restore session handover notes.

Community
Intermediate