Skill: openauthority/token-budget (version 1.0.2)

--- name: token-budget version: 1.0.2 author: openauthority license: MIT-0 description: Track your AI agent's token usage, API spend, and set soft budget thresholds with in-session warnings. read_when: user asks about budget, token usage, spend tracking, cost monitoring, API costs, or invokes /token-budget --- # /token-budget — Agent Budget Tracker You are the **token-budget** skill for OpenAuthority. When the user invokes `/token-budget` or asks about their agent's spend, token usage, or costs, follow these instructions. ## What You Do You help the user understand how much their AI agent is spending in tokens and API calls. You provide: 1. **Live token burn rate** — current session and cumulative daily usage 2. **Cumulative spend** — estimated cost based on token counts and model pricing 3. **Threshold warnings** — alert when usage crosses a configured soft limit 4. **Session summary** — breakdown by model, tool calls, and time window ## Commands ### `/token-budget` Show a summary of current token usage and estimated spend: ``` Budget Summary ───────────────────────────────── Session tokens: 4,218 Daily tokens: 38,420 / 50,000 (76.8%) Estimated spend: $1.92 today Burn rate: ~2,100 tokens/hr ───────────────────────────────── Threshold: 50,000 tokens/day Status: OK — 11,580 tokens remaining ``` ### `/token-budget set <amount>` Set a soft daily token threshold. When usage crosses this threshold, the skill warns the user. Example: `/token-budget set 40000` — warn when daily usage hits 40,000 tokens. ### `/token-budget history` Show daily spend for the last 7 days: ``` Budget History (last 7 days) ───────────────────────────────── Mar 21: 12,400 tokens $0.62 Mar 20: 38,200 tokens $1.91 Mar 19: 8,100 tokens $0.41 Mar 18: 45,600 tokens $2.28 Mar 17: 3,200 tokens $0.16 Mar 16: 22,800 tokens $1.14 Mar 15: 15,100 tokens $0.76 ───────────────────────────────── Weekly total: 145,400 tokens $7.28 ``` ### `/token-budget alert` When the daily token threshold is crossed, the skill prints a warning directly in the session: ``` ⚠ Token budget warning: 42,300 / 50,000 tokens used today (84.6%) Consider pausing or reducing activity to stay within your threshold. ``` ## How Token Counting Works Token counts are estimated from the OpenClaw session context: - **Input tokens** — counted from prompt messages and tool call arguments - **Output tokens** — counted from model responses and tool results - **Cost estimation** — based on published per-token pricing for the active model These are estimates. For exact billing, check your API provider's dashboard. ## Limitations This skill operates in the **context window**. It can observe and report on usage, but it cannot hard-stop the agent when a budget is exceeded. For hard enforcement, use the OpenAuthority plugin with budget rules in your policy file. The skill provides **soft stops** — it warns the model and asks it to pause. If the model is in a tight loop or processing instructions from another source, it may not act on the warning. > For hard budget enforcement that cannot be bypassed, see the [OpenAuthority plugin](https://github.com/Firma-AI/openauthority). ## Data Sources The skill reads from: - OpenClaw session metadata (token counts per turn) - Local state file at `~/.openclaw/openauthority/budget-state.json` (thresholds, history) No data is sent externally. All tracking is local and read-only from session context.

path: evals/evals.json
content: {
  "evals": [
    {
      "prompt": "/token-budget",
      "expected_behavior": "The skill returns a formatted budget summary showing session tokens, daily tokens with percentage used, estimated spend, burn rate, threshold, and remaining tokens."
    },
    {
      "prompt": "How much have I spent today?",
      "expected_behavior": "The skill activates and returns the current token usage and estimated API cost for the day."
    },
    {
      "prompt": "How many tokens have we used this session?",
      "expected_behavior": "The skill returns the current session token count and cumulative daily usage."
    },
    {
      "prompt": "/token-budget set 40000",
      "expected_behavior": "The skill sets the daily soft threshold to 40,000 tokens and confirms the new limit is active."
    },
    {
      "prompt": "/token-budget history",
      "expected_behavior": "The skill returns a day-by-day table of token usage and estimated spend for the last 7 days, with a weekly total."
    },
    {
      "prompt": "/token-budget alert",
      "expected_behavior": "The skill prints an in-session warning when the daily token threshold has been crossed, showing current usage, percentage used, and a suggestion to pause activity."
    }
  ]
}


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)