orc-budget

Forecasts token, dollar, and quota costs of an ORC execution plan from usage transcripts.

6|1|Updated Jul 4, 2026
One-click install
npx skills add https://github.com/azure-id/orc --skill orc-budget-azure-id
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: orc-budget
Source: https://github.com/azure-id/orc/tree/main/templates/skills/orc-budget
Command: npx skills add https://github.com/azure-id/orc --skill orc-budget-azure-id

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Before running a multi-task AI orchestration plan, you cannot know what it will cost in tokens, dollars, or subscription quota — and account-level dashboards only report spend after the fact. This Skill forecasts the cost of a specific plan forward, per scoring band, so you can choose a cheaper lane or split a risky task before any tokens are burned. ## Core Features & Use Cases - Plan-based cost forecasting: Takes a plan file (never a prose sentence) and produces a four-component token vector (input, cache write, cache read, output) per scoring band, always as a range with a sample count. - Four rendering views: Renders the same vector as raw tokens, dollars from a dated price table, percent of a 5-hour/weekly subscription quota window, and per-task context-window pressure. - Transcript-to-trace join: Joins Claude Code JSONL session transcripts with ORC dispatch traces to attribute real measured costs to tasks, with unattributed tokens always reported. - Use Case: Given a 14-task, 4-wave plan, ask what it will burn — get "1.23M raw / 564k weighted tokens, 18% of your 5-hour window" plus a warning that task T12 forecasts 189k of a 200k context window and should be split. ## Quick Start Ask the assistant to forecast what the current ORC plan will cost in tokens, dollars, and quota before running it.

Frequently Asked Questions about orc-budget

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I forecast the cost of an AI agent run before executing it?▼

Provide a plan file with task blocks and the forecast command computes a token vector per scoring band from historical usage data. It renders the result as tokens, dollars, quota percentage, and context-window risk, always as a range with a sample count.

How to estimate Claude Code token usage per task?▼

Token usage per task is measured by joining Claude Code's JSONL session transcripts, which record input, cache write, cache read, and output tokens per sidechain dispatch, with ORC trace lines that identify the task, band, and model. The join uses time windows and model matching.

Can I see cost as a percentage of my Claude Pro or Max quota?▼

Yes, the quota view renders weighted tokens as a percent of the 5-hour session window and weekly limit. Your plan is asked once and stored, because a guessed plan rendered as a percentage would be misleading.

Why does the forecast refuse to work from a plain sentence?▼

Forecasting from prose is guessing, and a guess that looks computed is worse than no answer. The forecast requires a plan file with task blocks; without one it exits with a pointer to the planning step.

What happens when there is no usage history to calibrate from?▼

With no joinable dispatches or transcripts, the forecast refuses to invent numbers and says so. A floor estimate from the public price table is available only via an explicit naive mode flag.

Does the budget forecast block a run if costs are too high?▼

No, the forecast is advisory always and never blocks a run. The only hard stop in this area is a separate dispatch-count gate, which is not part of this lane.