Agent skill

Speckit Token Budget Usage

by haru in haru/redmine_ai_helper

Show token usage for every SDD artifact in the active feature, the projected context window for each upcoming phase, and the savings already realized by token-budget (full backups vs current files).

MITAuto-check passedAI & LLM Engineering

Install Speckit Token Budget Usage

skills CLI
$ npx skills add haru/redmine_ai_helper --skill speckit-token-budget-usage -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install haru/redmine_ai_helper speckit-token-budget-usage --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/haru/redmine_ai_helper.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/speckit-token-budget-usage .claude/skills/speckit-token-budget-usage && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
speckit-token-budget-usage
GitHub stars
106
Token cost
~1k tokens
SKILL.md length
279 words
Files
1
Skills in repo
21
Repo updated
First seen
Licence
MIT

At a glance

Show token usage for every SDD artifact in the active feature, the projected context window for each upcoming phase, and the savings already realized by token-budget (full backups vs current files).

  • Works in 5 steps: Resolve scope → Enumerate artifacts → Project per-phase budgets → …
  • Tasks that involve LLM cost and token optimization
  • SKILL.md covers Your task and Algorithm
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Speckit Token Budget Usage is an agent skill from haru/redmine_ai_helper. Show token usage for every SDD artifact in the active feature, the projected context window for each upcoming phase, and the savings already realized by token-budget (full backups vs current files).

Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts. Compatibility notes: Requires spec-kit project structure with .specify/ directory

It sits in AI & LLM Engineering, covering LLM cost and token optimization and Spec-driven development. The repository describes itself as: A Redmine plugin that adds AI agents, MCP Server, smart completion, and vector search. The licence is MIT.

When your agent uses it

  • Tasks that involve LLM cost and token optimization
  • Tasks that involve Spec-driven development

Example prompts

  • “/speckit-token-budget-usage”

Requirements

  • Compatibility (from SKILL.md): Requires spec-kit project structure with .specify/ directory

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Resolve scope
  2. Enumerate artifacts
  3. Project per-phase budgets
  4. Render
  5. Recommendations (only when warranted)

What it can do on your machine

Read from SKILL.md and the folder at commit 3cd87d6. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    Requires spec-kit project structure with .specify/ directory

    From compatibility in the SKILL.md frontmatter.

Context cost

Speckit Token Budget Usage loads about 1k tokens when it runs. Until then it costs about 56 tokens; SKILL.md has 279 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~56
When it runs · the whole SKILL.md, loaded when a task matches
~1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from haru/redmine_ai_helper at commit 3cd87d6, republished under its MIT licence (© haru). 279 words, ~1,009 tokens.

Download SKILL.mdSave it as .claude/skills/speckit-token-budget-usage/SKILL.md (or your agent's skills folder).
name
speckit-token-budget-usage
description
Show token usage for every SDD artifact in the active feature, the projected context window for each upcoming phase, and the savings already realized by token-budget (full backups vs current files).
compatibility
Requires spec-kit project structure with .specify/ directory
metadata.author
Tinesoft
metadata.source
extension:token-budget
user-invocable
true
disable-model-invocation
false

Token Budget Usage Skill

/speckit.token-budget.usage

The user has invoked /speckit.token-budget.usage with arguments: $ARGUMENTS.

Your task

Inspect the active feature directory and produce a one-screen token-usage dashboard. Read-only — never modify artifacts.

Algorithm

Step 1 — Resolve scope

Default scope: the active feature (from current git branch). If $ARGUMENTS contains --all, walk every feature under specs/. If it contains --feature=<name>, target that feature.

Step 2 — Enumerate artifacts

For each artifact present, record:

  • path (relative to feature directory)
  • byte size
  • estimated token count (use estimate_tokens.sh)
  • whether a .full.md backup exists, and its token count if so
  • whether the file carries the <!-- token-budget: compacted --> marker

Standard artifact set: constitution.md, spec.md, plan.md, research.md, data-model.md, quickstart.md, tasks.md, every file in contracts/, plus any extra .md files in the feature root (treat as auxiliary).

Step 3 — Project per-phase budgets

For each upcoming phase the feature has not yet completed, sum the artifacts it would normally consume (from scope.phase_inputs in token-budget-config.yml). Show two numbers per phase: current size, and size if every artifact were compacted (estimated as 60% for medium, 45% for aggressive — these are heuristics, not guarantees, and should be labeled as such).

Step 4 — Render

Output exactly this layout. Right-align numbers. Use thousands separators. Pad with spaces, not tabs.

Token Budget — feature: <feature-name>
Path: specs/<feature-name>/

Artifact                tokens     vs full       status
─────────────────────────────────────────────────────────────────
constitution.md          1,240          —        baseline
spec.md                  2,310     -52.1%        compacted (medium)
plan.md                  3,580     -41.7%        compacted (medium)
research.md              1,180     -63.1%        compacted (medium)
data-model.md            1,840          —        baseline
contracts/orders.yaml      910          —        schema (not eligible)
contracts/users.yaml       820          —        schema (not eligible)
quickstart.md              640          —        baseline
tasks.md                 4,210          —        baseline
─────────────────────────────────────────────────────────────────
total                   16,730     -27.4% vs uncompacted

Projected phase budgets
                       current    if aggressive compact
plan       (done)            —                       —
tasks      (done)            —                       —
implement                12,560                   ~7,540
analyze                  10,100                   ~6,060

Backups present: spec.full.md, plan.full.md, research.full.md
Concise mode: <on|off>  (memory file: <path>)

If --all was passed, repeat the artifact table once per feature and add a final cross-feature roll-up showing the total savings.

Step 5 — Recommendations (only when warranted)

If any single artifact exceeds 5,000 tokens and is not compacted, append a one-line nudge:

Suggestion: tasks.md is 6,140 tokens. /speckit.token-budget.compact tasks
would likely save ~40%.

If concise mode is off and the project is large (more than 12k total tokens), suggest:

Suggestion: /speckit.token-budget.concise on  (estimated 5–15% output savings)

Only emit suggestions that are actually warranted by the numbers. No generic advice.

End the response. The dashboard is the deliverable.

© haru, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills/speckit-token-budget-usage of haru/redmine_ai_helper.

Open the folder on GitHubat commit 3cd87d6

Compare with similar skills

Speckit Token Budget Usage next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Speckit Token Budget Usage compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Speckit Token Budget Usage this skillharu/redmine_ai_helper106—~1kAutomated safety check: PassMIT
Cost Trackerrohitg00/pro-workflow2.9k—~814Automated safety check: PassNone
Context Compressionguanyang/open-agent-hub9772 repos~4.6kAutomated safety check: PassMIT
Fleet Auditoralexgreensh/token-optimizer2.5k—~1.7kAutomated safety check: PassCustom licence
Context Auditundefined-ui/second-brain-os1k—~802Automated safety check: PassMIT
HoneyGreen-PT/honey-for-devs313—~3.5kAutomated safety check: PassMIT

Similar skills

  • Cost Tracker

    rohitg00/pro-workflow

    Track session costs, set budget alerts, and optimize token spend.

    2.9k GitHub stars~814 tokensUpdated 10 days ago
    AI & LLM EngineeringAuto-check passed
  • Context Compression

    guanyang/open-agent-hub

    This skill should be used when long-running agent sessions need context compression, structured summarization, compaction, token-per-task optimization, or durable handoff summaries that preserve…

    977 GitHub starsUsed in 2 repos~4.6k tokens
    AI & LLM EngineeringAuto-check passed
  • Fleet Auditor

    alexgreensh/token-optimizer

    Cross-system agent token/cost audit (Claude Code, Codex, OpenClaw, Hermes, OpenCode): idle burns, model misrouting, config bloat, with dollar savings.

    2.5k GitHub stars~1.7k tokensUpdated yesterday
    AI & LLM EngineeringAuto-check passed
  • Context Audit

    undefined-ui/second-brain-os

    Audit an agent's context layout against the four places: system prompt, tools, history, tail.

    1k GitHub stars~802 tokensUpdated 2 days ago
    AI & LLM EngineeringAuto-check passed
  • Honey

    Green-PT/honey-for-devs

    Write less code and say less about it. An agent skill from Green-PT/honey-for-devs.

    313 GitHub stars~3.5k tokensUpdated 1 mo ago
    AI & LLM EngineeringAuto-check passed
  • Mines local Claude Code session transcripts with a deterministic Python pipeline to show what the agent is actually used for, how often it fails and what it costs.

    1.6k GitHub stars~2.3k tokensUpdated yesterday
    AI & LLM EngineeringAuto-check passed

More from haru/redmine_ai_helper

All 21 skills in this repo
  • Commit

    haru/redmine_ai_helper

    Stage the current changes and create a git commit with a properly formatted English message.

    106 GitHub stars~1.1k tokensUpdated yesterday
    Auto-check: notes
  • Create Pull Request

    haru/redmine_ai_helper

    Create a pull request from the current branch. An agent skill from haru/redmine_ai_helper.

    106 GitHub stars~1.5k tokensUpdated yesterday
    Auto-check passed
  • Create Release Branch

    haru/redmine_ai_helper

    Create a release branch for a given version. An agent skill from haru/redmine_ai_helper.

    106 GitHub stars~599 tokensUpdated yesterday
    Auto-check passed
  • Qlty Check

    haru/redmine_ai_helper

    Code quality checks, formatting, and metrics via qlty CLI. An agent skill from haru/redmine_ai_helper.

    106 GitHub starsUsed in 2 repos~628 tokens
    Auto-check passed
  • Redmine Playwright Login

    haru/redmine_ai_helper

    Connect to the running Redmine instance and log in via the Playwright MCP browser, using REDMINEPLAYRIGHTURL/REDMINEPLAYRIGHTUSER/REDMINEPLAYRIGHTPASSWORD environment variables.

    106 GitHub stars~796 tokensUpdated yesterday
    Auto-check passed
  • Recreate Test DB

    haru/redmine_ai_helper

    Recreate the Redmine test database from scratch (delete db/schema.rb and db/redmine.sqlite3test, then run core and plugin migrations with RAILSENV=test).

    106 GitHub stars~364 tokensUpdated yesterday
    Auto-check passed

Questions about Speckit Token Budget Usage

What does Speckit Token Budget Usage do?

Show token usage for every SDD artifact in the active feature, the projected context window for each upcoming phase, and the savings already realized by token-budget (full backups vs current files). Speckit Token Budget Usage is an agent skill from haru/redmine_ai_helper. Show token usage for every SDD artifact in the active feature, the projected context window for each upcoming phase, and the savings already realized by token-budget (full backups vs current files).

When should I use Speckit Token Budget Usage?

Speckit Token Budget Usage fits situations like: tasks that involve LLM cost and token optimization; tasks that involve Spec-driven development.

How do I install Speckit Token Budget Usage in Claude Code?

Run `npx skills add haru/redmine_ai_helper --skill speckit-token-budget-usage -a claude-code`. Or copy the skill folder (.claude/skills/speckit-token-budget-usage in haru/redmine_ai_helper) into .claude/skills/speckit-token-budget-usage in your project. Claude Code loads it when a task matches its description.

How do I install Speckit Token Budget Usage in Codex?

Run `npx skills add haru/redmine_ai_helper --skill speckit-token-budget-usage -a codex`. Or copy the skill folder (.claude/skills/speckit-token-budget-usage in haru/redmine_ai_helper) into .agents/skills/speckit-token-budget-usage in your project. Codex loads it when a task matches its description.

Can I use Speckit Token Budget Usage in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add haru/redmine_ai_helper --skill speckit-token-budget-usage -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/speckit-token-budget-usage, .gemini/skills/speckit-token-budget-usage, .github/skills/speckit-token-budget-usage and .opencode/skills/speckit-token-budget-usage in your project.

What does Speckit Token Budget Usage need to run?

SKILL.md names no scripts, command-line tools or credentials: Speckit Token Budget Usage is instructions for the agent only. Compatibility (from SKILL.md): Requires spec-kit project structure with .specify/ directory.

Does Speckit Token Budget Usage access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Speckit Token Budget Usage safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Speckit Token Budget Usage use?

Speckit Token Budget Usage is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Speckit Token Budget Usage use?

About 1k tokens (SKILL.md is roughly 4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Speckit Token Budget Usage?

Skills that share tags, products or a category with Speckit Token Budget Usage: Cost Tracker (rohitg00/pro-workflow, 2.9k stars), Context Compression (guanyang/open-agent-hub, 977 stars), Fleet Auditor (alexgreensh/token-optimizer, 2.5k stars) and Context Audit (undefined-ui/second-brain-os, 1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Speckit Token Budget Usage?

haru (a GitHub user) maintains it in haru/redmine_ai_helper, which has 106 GitHub stars. The repository holds 21 skills in this directory. The repository was last updated on October 9, 2026.

Source: haru/redmine_ai_helper on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.