context-budget-guard
Proactively monitors estimated token usage during long sessions and triggers context-window-management before overflow, not after. Use at the start of any session expected to last more than 30 minutes.
How do I install this agent skill?
npx skills add https://github.com/archieindian/openclaw-superpowers --skill context-budget-guardIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill is a monitoring utility designed to help AI agents manage their context window usage. It tracks session duration and estimates token consumption to suggest when context compaction is needed. The analysis found no security risks; it does not access sensitive files, perform network operations, or include any obfuscated code. It follows secure coding practices, such as using safe YAML loading.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
Context Budget Guard
State file: ~/.openclaw/skill-state/context-budget-guard/state.yaml
Don't wait for the model to go incoherent. Act at 70%, not 95%.
When to Use
- At the start of any long-running session (>30 min expected)
- Before each major task step in a multi-hour workflow
- When
long-running-task-managementadvances to a new stage
The Process
Step 1: Initialize (Session Start)
Write to state: session_start timestamp, compaction_count: 0, status: monitoring, threshold_pct: 70.
Step 2: Check Budget (Before Each Major Step)
Estimate current context usage as a rough percentage:
- Low (<50%) — continue normally
- Medium (50–70%) — note in state, proceed with caution (avoid loading large files)
- High (>70%) — trigger
context-window-managementNOW, before continuing
To estimate: count approximate tokens from recent messages, loaded file contents, and active task context.
Step 3: After Compaction
- Increment
compaction_countin state - Write
last_compacted_at,strategy_used(passed fromcontext-window-management) - Reset mental estimate to ~20% (post-compaction baseline)
Step 4: Session End
Update state: status: idle, session_end timestamp.
Key Principles
- The 70% threshold is the trigger — earlier is always better than later
- Check budget BEFORE loading large files or running subagents, not after
- If in doubt: compact. A clean context costs less than a confused one.
- Works best paired with
long-running-task-management— check budget at every checkpoint
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/archieindian/openclaw-superpowers/context-budget-guard">View context-budget-guard on skillZs</a>