How does this skill detect when to suggest a compact?

It uses a PreToolUse hook to track the number of Edit and Write tool calls, triggering a notification once a specific threshold (default 50 calls) is reached.

Does this skill automatically run the /compact command?

No, it only suggests that you run /compact at strategic moments, giving you the final decision on whether the current context is still necessary.

What is the benefit of manual compaction over auto-compaction?

Auto-compaction can trigger at arbitrary points, potentially losing context mid-task. Strategic manual compaction lets you choose logical milestones to clear history while keeping essential data.

Can I change the frequency of the compaction reminders?

Yes, you can customize the COMPACT_THRESHOLD environment variable to define exactly when you want the first suggestion to appear.

Strategic Context Compaction

Name: Strategic Context Compaction
Author: filipas123

byfilipas123

•

Productivity & Workflow

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

Strategic Context Compaction is a workflow enhancement skill for Claude Code designed to prevent the loss of critical information caused by automatic context management. By monitoring tool call volume and prompting for manual compaction after major milestones—such as transitioning from research to implementation—this skill ensures that your session context remains relevant and high-quality. It allows developers to clear out exploration noise while preserving essential project state, leading to more accurate code generation during complex, long-running tasks.

Key Features

01Configurable tool call limits for tailored workflow monitoring

02Best practice guidance for managing AI memory at logical boundaries

03Context-aware compaction prompts based on tool usage thresholds

04Periodic reminders to prevent context bloat during extended sessions

05Seamless integration with PreToolUse hooks for Edit and Write operations

061 GitHub stars

Use Cases

01Clearing exploration logs and research context before starting a fresh development phase

02Managing large-scale refactors where arbitrary auto-compaction might drop specific implementation details

03Maintaining high token efficiency and performance during multi-step debugging sessions

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add filipas123/claude-code-pkc-v1 strategic-compact

For use in Claude.ai and ChatGPT

Download Skill