Can I customize the frequency of the compaction reminders?

Yes, you can configure the COMPACT_THRESHOLD environment variable to set the number of tool calls that occur before the first suggestion is made.

How does this skill monitor my session?

The skill uses a shell script hooked into PreToolUse events to count the number of times tools like 'Edit' or 'Write' are invoked, providing a suggestion once a specific threshold is reached.

Does this skill automatically compact my code?

No, it only suggests that you run the /compact command. You retain full control over when the compaction actually occurs, ensuring it doesn't happen in the middle of a complex change.

What is strategic compaction?

Strategic compaction is the process of manually triggering a context refresh at logical stopping points in a workflow to ensure that important task information is preserved while irrelevant history is discarded.

Strategic Context Compaction

Name: Strategic Context Compaction
Author: x-cmd

byx-cmd

•

Productivity & Workflow

Optimizes Claude's memory usage by suggesting manual context compaction at logical task boundaries instead of arbitrary intervals.

Strategic Context Compaction is a productivity skill designed to help developers maintain relevant context during long-form coding sessions. Instead of relying on Claude's automatic compaction, which can trigger mid-task and lead to the loss of critical implementation details, this skill monitors tool usage and prompts users to compact their session at strategic milestones. By suggesting a refresh after planning, debugging, or reaching a milestone, it ensures that your most valuable architectural decisions are preserved while clearing out temporary exploration noise, leading to more coherent and efficient AI interactions.

Key Features

01Periodic reminders to maintain context hygiene

02Optimization for long-running coding and agent tasks

03Intelligent tool call tracking for session monitoring

049 GitHub stars

05PreToolUse hooks for Edit and Write actions

06Configurable suggestion thresholds (default 50 calls)

Use Cases

01Preserving architectural plans when transitioning from research to active implementation.

02Resetting session context after a major feature milestone to start the next phase with a clean slate.

03Clearing out verbose error logs and debugging history after a bug is successfully resolved.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add x-cmd/skill strategic-compact

For use in Claude.ai and ChatGPT

Download Skill