compaction-viewer

Analyze compaction-debugger logs to validate context preprocessing and compression.

Updated Apr 5, 2026
One-click install
npx skills add https://github.com/Lsogod/compaction-debugger --skill compaction-viewer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: compaction-viewer
Source: https://github.com/Lsogod/compaction-debugger/tree/main/skills/compaction-viewer
Command: npx skills add https://github.com/Lsogod/compaction-debugger --skill compaction-viewer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps operators verify and understand how the compaction-debugger plugin preprocesses context and what remains after compression, enabling targeted debugging of token savings and recent-message retention.

Core Features & Use Cases

  • Read and parse the latest assemble-, before-compaction-, and after-compaction logs from the local log directory.
  • Compare pre- and post-compaction transcripts to identify what was condensed and what was preserved.
  • Provide quick diagnostics on whether pre-processing was applied and how it affected the current session.

Quick Start

List the latest logs and summarize the pre-processing and compaction results for the current session.

Frequently Asked Questions about compaction-viewer

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

FAQPage Schema
How do I inspect compaction logs to verify token savings?

Inspect compaction logs by reading assemble, before-compaction, and after-compaction JSON files to compare pre- and post-compression transcripts, validating token savings and recent-message retention for your session.

What is context preprocessing and how does it affect compaction debugging?

Context preprocessing in compaction debugging is the mechanism that condenses transcript data before compression, and analyzing before-compaction logs reveals exactly what was preserved or removed to affect overall token savings.

How do I check what transcript messages are retained after context compression?

Check retained transcript messages by comparing before-compaction and after-compaction JSON log files, which provide evidence-based diagnostics on what data was condensed and what was preserved across sessions.

Does the compaction viewer work without external dependencies or plugins?

Yes, the compaction viewer works without external dependencies, relying solely on reading local log directory files like assemble-*.json to provide diagnostics on preprocessing and token savings.

What is the best way to debug recent-message retention across sessions?

The best way to debug recent-message retention is to parse the latest after-compaction logs from your local directory, summarizing preprocessing results to assess what transcript data remains after compression.