headroom

Compress tool outputs, logs, and conversation history to reduce token usage.

1|Updated Jul 12, 2026
One-click install
npx skills add https://github.com/Tyler-R-Kendrick/slm-training --skill headroom-tyler-r-kendrick
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: headroom
Source: https://github.com/Tyler-R-Kendrick/slm-training/tree/main/.agents/skills/headroom
Command: npx skills add https://github.com/Tyler-R-Kendrick/slm-training --skill headroom-tyler-r-kendrick

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill solves the problem of excessive token consumption and high latency in agentic loops by intelligently compressing tool outputs, logs, and conversation history without losing critical information.

Core Features & Use Cases

  • Intelligent Compression: Automatically applies content-specific transforms (SmartCrusher, LogCompressor, SearchCompressor) to reduce token usage by up to 99%.
  • Reversible Context: Maintains a local CCR cache, ensuring that any compressed data can be retrieved in its original form if needed for deeper analysis.
  • Output Shaping: Enforces verbosity levels (L0-L4) to prevent agents from restating known information or generating unnecessary reasoning, optimizing the agent's own output.

Quick Start

Use the headroom skill to compress the output of the last tool execution to reduce token usage.

Frequently Asked Questions about headroom

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

FAQPage Schema
How do I reduce token consumption from large build logs in agentic workflows?

To reduce token consumption from large build logs, you can compress tool outputs and conversation history using heuristic-based selection. This mechanism applies content-specific transforms to minimize token usage and latency for coding agents without losing critical information.

What is context compression for LLM optimization?

Context compression for LLM optimization is the process of applying content-specific transforms to large tool outputs and conversation history. It minimizes token consumption and latency by using heuristic-based selection to shrink diverse content types like JSON arrays and source code files.

Can I retrieve original data after compressing conversation history?

Yes, you can retrieve original data after compressing conversation history because the mechanism implements a reversible caching mechanism. It maintains a local CCR cache to ensure data integrity, allowing compressed data to be retrieved in its original form for deeper analysis.

Does context compression work with JSON arrays and source code files?

Yes, context compression works with JSON arrays and source code files. It operates across diverse content types using heuristic-based selection, applying specific transforms like SmartCrusher and SearchCompressor to effectively reduce token usage across various formats.

How do I enforce verbosity levels to optimize agent output?

You enforce verbosity levels from L0 to L4 to optimize agent output by shaping the response generation process. This prevents agents from restating known information or generating unnecessary reasoning, directly reducing the agent's own output tokens.

What are the limitations of heuristic-based context compression?

A limitation of heuristic-based context compression is that it relies on heuristic selection rather than semantic understanding, which may require retrieving original data from the CCR cache for complex analysis. It is designed to maintain a stable KV cache rather than deep content interpretation.