← Back to Skills Marketplace
Automation Tool:
374
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install context-budgeting-v2
Description
Manage and optimize OpenClaw context window usage via partitioning, pre-compression checkpointing, and information lifecycle management. Use when the session...
README (SKILL.md)
Context Budgeting Skill
This skill provides a systematic framework for managing the finite context window (RAM) of an OpenClaw agent.
Core Concepts
1. Information Partitioning
- Objective/Goal (10%): Core task instructions and active constraints.
- Short-term History (40%): Recent 5-10 turns of raw dialogue.
- Decision Logs (20%): Summarized outcomes of past steps ("Tried X, failed because Y").
- Background/Knowledge (20%): High-relevance snippets from MEMORY.md.
2. Pre-compression Checkpointing (Mandatory)
Before any compaction (manual or automatic), the agent MUST:
- Generate Checkpoint: Update
memory/hot/HOT_MEMORY.mdwith:- Status: Current task progress.
- Key Decision: Significant choices made.
- Next Step: Immediate action required.
- Run Automation: Execute
scripts/gc_and_checkpoint.shto trigger the physical cleanup.
Automation Tool: gc_and_checkpoint.sh
Located at: skills/context-budgeting/scripts/gc_and_checkpoint.sh
Usage:
- Run this script after updating
HOT_MEMORY.mdto finalize the compaction process without restarting the session.
Integration with Heartbeat
Heartbeat (every 30m) acts as the Garbage Collector (GC):
- Check
/status. If Context > 80%, trigger the Checkpointing procedure. - Clear raw data (e.g., multi-megabyte JSON outputs) once the summary is extracted.
Usage Guidance
This skill appears to do what it says (manage context), but it contains unsafe assumptions and omissions. Before installing: (1) review and edit scripts/gc_and_checkpoint.sh — replace the hard-coded WORKSPACE with a configurable path and verify it points to the intended directory; (2) confirm the 'openclaw' CLI exists and is the correct binary, and add that as a declared dependency; (3) back up HOT_MEMORY.md and any large raw outputs — compaction can delete or permanently discard raw data; (4) test the script in a non-production environment to confirm behavior; (5) ask the author why no required binaries/config paths were declared and request explicit documentation for the heartbeat /status check; (6) if you cannot verify the script and its effects, do not run it with real sessions or sensitive data. These issues look like sloppy configuration rather than clearly malicious code, but they create an elevated risk of accidental data loss or unintended session changes.
Capability Analysis
Type: OpenClaw Skill
Name: context-budgeting-v2
Version: 1.0.0
The skill bundle is designed for managing an AI agent's context window through information partitioning and session compaction. The primary script, `scripts/gc_and_checkpoint.sh`, performs legitimate maintenance tasks such as triggering the OpenClaw CLI to compact sessions and referencing a local memory file. While it contains a hardcoded user path (/Users/yang/clawd), there is no evidence of data exfiltration, malicious execution, or prompt injection intended to subvert the agent's behavior.
Capability Assessment
Purpose & Capability
The skill claims to manage context but the distributed artifacts reveal mismatches: the provided script invokes an 'openclaw' CLI and references a hard-coded workspace (/Users/yang/clawd), yet the registry metadata declares no required binaries or config paths. A context-budgeting tool plausibly needs an OpenClaw control mechanism, but the skill should declare that dependency and a configurable workspace path instead of embedding a specific user's path.
Instruction Scope
SKILL.md mandates creating/updating memory/hot/HOT_MEMORY.md and running the script to 'finalize compaction' and instructs removing large raw data after summarization. Those actions directly modify local session state and can cause loss of raw outputs if run incorrectly. The instructions also reference a 'Heartbeat' check and '/status' without specifying how to access that status endpoint or what privileges are required.
Install Mechanism
There is no install spec (instruction-only) which limits on-disk risk, but the included scripts/gc_and_checkpoint.sh will run locally and call external binaries. The lack of an install spec is not itself dangerous, but the script assumes the presence of an 'openclaw' command and a specific filesystem layout without declaring or installing them.
Credentials
The skill requests no environment variables or credentials, which superficially looks benign, but the script accesses a hard-coded absolute path and will read/write HOT_MEMORY.md under that workspace. This is disproportionate because the skill did not declare the need to access that path or the openclaw CLI; it therefore may unexpectedly touch user files. No secrets are requested, however.
Persistence & Privilege
The skill is not always-enabled and does not request persistent privileges. It does invoke session compaction via the OpenClaw CLI which alters agent/session state — a legitimate action for this skill — but combined with the undeclared dependency and hard-coded path, it increases the risk of unintended state changes.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install context-budgeting-v2 - After installation, invoke the skill by name or use
/context-budgeting-v2 - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of the context-budgeting skill for OpenClaw agents.
- Introduces a structured framework for managing context window usage, including partitioning information into objectives, history, decision logs, and background knowledge.
- Implements mandatory pre-compression checkpointing with updates to `HOT_MEMORY.md` and automation via `gc_and_checkpoint.sh`.
- Integrates an automated heartbeat mechanism to monitor context usage and trigger cleanup when limits are exceeded.
- Aims to minimize token costs, reduce latency, and prevent memory loss during long-running sessions.
Metadata
Frequently Asked Questions
What is Context Budgeting Pro?
Manage and optimize OpenClaw context window usage via partitioning, pre-compression checkpointing, and information lifecycle management. Use when the session... It is an AI Agent Skill for Claude Code / OpenClaw, with 374 downloads so far.
How do I install Context Budgeting Pro?
Run "/install context-budgeting-v2" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Context Budgeting Pro free?
Yes, Context Budgeting Pro is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Context Budgeting Pro support?
Context Budgeting Pro is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Context Budgeting Pro?
It is built and maintained by MKGNBEAR (@mkgnbear); the current version is v1.0.0.
More Skills