What problem does it solve? Auto-compaction in long AI coding sessions triggers at arbitrary points, often mid-task, discarding important context like file paths and partial state. This Skill helps you compact context at logical phase transitions instead, preserving what matters across research, planning, implementation, and testing phases. ## Core Features & Use Cases - Tool-Call Threshold Detection: A PreToolUse hook script counts Edit/Write invocations per session and suggests running /compact once a configurable threshold (default 50 calls) is reached, with reminders every 25 calls afterward. - Compaction Decision Guide: A built-in table tells you when compacting is safe (research to planning, after debugging) and when it is costly (mid-implementation). - Context Survival Reference: Documents what persists across compaction (CLAUDE.md, TodoWrite lists, memory files, git state) versus what is lost, so you can save key context to files before compacting. - Use Case: During a long feature build, after finalizing your plan in a todo list, the hook reminds you at 50 tool calls to run /compact with a summary message, freeing context for implementation without losing the plan. ## Quick Start Install the suggest-compact hook in your Claude settings for Edit and Write tool events, then ask the AI to remind you when a strategic compaction point is reached during long sessions.
