Skip to content
TakoAPI
Back to skills

hz-context-optimizer

by lidekahdjdhdhsjjs-lang

CLI Utilities
299Downloads reported by clawskills.sh
2Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

This skill should be used when the user asks to "compress context", "summarize conversation history", "implement.

Description

What This Skill Does

Techniques for compressing agent conversation history without losing critical information. Covers three production-ready approaches: anchored iterative summarization, opaque compression, and regenerative full summaries. The core insight is optimizing tokens-per-task rather than tokens-per-request, since overly aggressive compression forces costly re-fetching.

Targeting tokens-per-task instead of tokens-per-request avoids the hidden cost where compression that saves 0.5% more tokens causes 20% more re-fetching, resulting in higher total token spend.

When to Use It

  • Compressing a 100+ message debugging session before hitting context limits
  • Tracking which files were modified across a multi-hour coding agent session
  • Designing summarization triggers for codebases over 5M tokens
  • Evaluating compression quality with probe-based recall tests
  • Reducing total token spend on long-running agentic workflows

Example Workflow

INPUT

User asks: Compress this 89,000-token debugging session so the agent can continue without losing context

AGENT
  1. 1

    Identify the compression trigger point at 70-80% context utilization

  2. 2

    Define structured summary sections: Session Intent, Files Modified, Decisions Made, Current State, Next Steps

  3. 3

    Summarize the truncated history span into each explicit section

  4. 4

    Merge the new summary into any existing structured summary rather than regenerating from scratch

  5. 5

    Validate retention by running probe questions against the compressed output

OUTPUT

A structured markdown summary preserving the original error, all modified file paths, root cause, test status, and next steps — compressing 89,000 tokens to roughly 300 words

Installation

clawhub install lidekahdjdhdhsjjs-lang/hz-context-optimizer

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links