smart-compaction

Summarize session contexts into decision-focused snapshots via PreCompact hook or /compact command.

Updated Jan 25, 2026
One-click install
npx skills add https://github.com/erhankaraarslan/agent_yazilim_ekibi --skill smart-compaction
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: smart-compaction
Source: https://github.com/erhankaraarslan/agent_yazilim_ekibi/tree/main/.claude/skills/smart-compaction
Command: npx skills add https://github.com/erhankaraarslan/agent_yazilim_ekibi --skill smart-compaction

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill compactly summarizes lengthy session context, preserving essential decisions, ADRs, and open tasks while removing noisy, non-critical details to stay within context limits.

Core Features & Use Cases

  • Automatic context compaction: triggers via the PreCompact hook to create a concise, decision-focused snapshot.
  • Manual compaction: invoked with the /compact command to create on-demand context summaries.
  • Audit-ready outputs: updates CLAUDE.md and the feature list to reflect current state and next steps.
  • Decision preservation: ensures active feature, ADRs, and critical file paths remain accessible after compaction.

Quick Start

Trigger automatic compaction via the PreCompact hook or issue a manual compact using /compact. Review the CLAUDE.md updates and update the feature-list.json after the pass. Save and proceed with the new compacted context for subsequent sessions.

Frequently Asked Questions about smart-compaction

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

FAQPage Schema
How do I compress long session context without losing key decisions?

Session context compaction summarizes lengthy contexts by preserving essential ADRs, active feature updates, and open tasks while trimming non-critical noise. It updates CLAUDE.md and the feature list to prepare a concise, actionable context snapshot for subsequent work.

Can I trigger context summarization automatically before hitting limits?

Automatic context summarization triggers via the PreCompact hook to create a concise, decision-focused snapshot before context limits are reached. You can also invoke manual compaction on-demand using the /compact command during long sessions.

What's the best way to maintain ADRs and open tasks during context compaction?

Maintaining ADRs and open tasks during context compaction involves updating CLAUDE.md and feature-list.json to reflect the current state and next steps. This ensures critical file paths and active feature decisions remain accessible after the pass.

Does manual compaction work the same as automatic PreCompact hook summarization?

Manual compaction via the /compact command and automatic summarization via the PreCompact hook both produce concise, audit-ready context snapshots. Manual invocation allows on-demand context summaries, while the hook operates automatically at session end or limits.

Why does my session lose important file paths after context compaction?

Context compaction preserves essential decisions, ADRs, and critical file paths while removing noisy details. If important paths are lost, review the updated CLAUDE.md and feature-list.json outputs to ensure active feature tracking remains accessible after the pass.

Do I need to update CLAUDE.md manually after running a context compaction pass?

Context compaction automatically updates CLAUDE.md and the feature list to reflect current state and next steps. You should review these audit-ready outputs after the pass, then save and proceed with the new compacted context for subsequent sessions.