token-usage-prediction Skill

Source

• Creator: microsoft
• Repository: microsoft/upgrade-agent-plugins
• Skill file: plugins/upgrade-agent/upgrade/skills/system/token-usage-prediction/SKILL.md

What it does

Estimate and present the token-usage budget for an upgrade before execution. Run this when the user directly requests an estimate, or to present a budget that the assessment tool already appended to its output. Never auto-run it after assessment — that path is now handled programmatically by the assessment tool.

Skill instructions

Token Usage Prediction Pre-execution token budget for the active scenario. Lets the user decide whether to proceed, narrow scope, or switch models before the agent starts spending tokens. The prediction is token-only — no monetary cost is reported. When to call Token estimation is user-initiated. Only run it when one of these is true: 1. The user directly asks ("how big will this be?", "recompute estimate", "how many tokens will the plan take?", "estimate for task X") — honor the request regardless of scenario, even when no scenario is active. 2. You are presenting a budget the assessment tool already appended. The dotnet-version-upgrade assessment tool computes the post-assessment budget itself (gated by the UPGRADEAGENTESTIMATETOKENSAFTERASSESSMENT env var) and appends it — already formatted with presentation guidance — to its own output. When that block is present, just present it as-is; do not call predicttokenusage to recompute it. When that block is absent, do nothing: never call