← Back to Skills Marketplace
126
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install token-budget-guard
Description
Automatically manages and compresses context to optimize token usage by summarizing, selectively loading, and budgeting for tool schemas, history, and tasks.
Usage Guidance
This skill appears to be what it claims — a set of best-practice instructions to reduce token usage — but exercise caution before installing it into a live agent environment. Recommendations:
- Review the SKILL.md yourself for any lines that explicitly instruct an agent to overwrite its system prompt, ignore safety rules, or call out to unknown endpoints; the scanner found a possible 'system-prompt-override' pattern which may be a false positive but should be checked.
- Do not copy the file into global or shared agent skill directories until you confirm it only contains benign guidance; prefer installing into a sandboxed/test agent first.
- If you let an agent follow the examples (jq, grep, head), ensure the agent is not given blanket filesystem access to sensitive directories (e.g., /etc, ~/.ssh, cloud credential files). Limit the agent's file-read scope to project folders.
- Monitor the agent's behavior during initial runs: log commands the agent issues and any files it reads, and validate summaries before they are used for privileged actions.
- If you need higher assurance, ask the skill author for provenance or a signed release; absent that, keep confidence moderate and treat the skill as useful but requiring manual oversight.
Capability Analysis
Type: OpenClaw Skill
Name: token-budget-guard
Version: 2.0.0
The bundle is a collection of Markdown-based instructions and templates designed to optimize token usage and manage costs for AI agents. It promotes efficient practices such as progressive disclosure of tool schemas, conversation summarization, and selective file reading using standard utilities like grep and jq. No malicious code, data exfiltration attempts, or harmful prompt injections were identified across SKILL.md, README.md, or the cost tracking template.
Capability Assessment
Purpose & Capability
Name/description (manage/compress context, budget schemas/history) matches the SKILL.md content and the provided templates. The strategies, progressive disclosure, and examples are coherent with the stated purpose and do not request unrelated services or credentials.
Instruction Scope
All runtime instructions are textual guidance (summarize, progressive disclosure, selective file reads) and example shell commands (grep, jq, head). The skill suggests copying SKILL.md into agent skill folders and gives examples of file operations; it does not explicitly instruct reading secrets or external endpoints. Because it advises running shell commands, a deployed agent could use those to access local files — this is expected for a file-selective strategy but increases the surface that should be reviewed.
Install Mechanism
Instruction-only skill with no install spec, no downloads, and no code files — lowest install risk. The README suggests manual copy into agent skill directories (user-level paths), which is normal for instruction-only skills and does not include remote installers or archive extraction.
Credentials
The skill requests no environment variables, no credentials, and no config paths. This aligns with its purely instructional nature; nothing asks for unrelated secrets or external tokens.
Persistence & Privilege
always:false and disable-model-invocation:false (normal). The README encourages copying the SKILL.md into agent skill locations, which would persist behavior in the agent environment — this is reasonable for a skill but means you should avoid copying it into shared/global system locations until you trust it.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install token-budget-guard - After installation, invoke the skill by name or use
/token-budget-guard - Provide required inputs per the skill's parameter spec and get structured output
Version History
v2.0.0
v2: Real impact numbers, progressive disclosure diagram, vs monitoring tools comparison
v1.0.0
Initial release: 99% token savings through progressive disclosure
Metadata
Frequently Asked Questions
What is Token Budget Guard?
Automatically manages and compresses context to optimize token usage by summarizing, selectively loading, and budgeting for tool schemas, history, and tasks. It is an AI Agent Skill for Claude Code / OpenClaw, with 126 downloads so far.
How do I install Token Budget Guard?
Run "/install token-budget-guard" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Token Budget Guard free?
Yes, Token Budget Guard is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Token Budget Guard support?
Token Budget Guard is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Token Budget Guard?
It is built and maintained by Erwin (@aptratcn); the current version is v2.0.0.
More Skills