speckit-token-observability

Track token usage across Spec Kit orchestration and workflow phases.

Updated May 18, 2026
One-click install
npx skills add https://github.com/KamiJeong/tech-bridge-book --skill speckit-token-observability
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-token-observability
Source: https://github.com/KamiJeong/tech-bridge-book/tree/main/.agents/skills/speckit-token-observability
Command: npx skills add https://github.com/KamiJeong/tech-bridge-book --skill speckit-token-observability

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a required observability workflow for Spec Kit and custom orchestration phases, helping teams record token usage consistently instead of skipping analysis or losing phase-by-phase visibility.

Core Features & Use Cases

  • Phase Coverage: Captures token data for Spec Kit phases such as specify, plan, tasks, and implement, plus custom orchestration phases like intake, slicing, scheduling, integration, review, commit, and PR creation.
  • Run Reporting: Organizes each run with a stable label and writes metadata, step records, summaries, reports, and quality notes into the token-analysis directory structure.
  • Guardrails and Budgets: Checks for the token-analyzer extension, handles missing data with explicit warnings, and reports budget status and required notes for final outputs.
  • Use Case: A team running a multi-agent Spec Kit workflow can verify token cost by phase before approving implementation or PR automation.

Quick Start

Use the speckit-token-observability skill to record token usage for a completed Spec Kit phase run and summarize the results.

Frequently Asked Questions about speckit-token-observability

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

FAQPage Schema
How do I track token usage across Spec Kit workflow phases?

To track token usage across Spec Kit workflow phases, you need a token observability process that captures data for specify, plan, tasks, and implement phases. It normalizes run labels and writes metadata, step records, and summaries into a token-analysis directory.

Can I check token budgets before approving Spec Kit PR automation?

Yes, you can check token budgets before approving Spec Kit PR automation by applying phase-level reporting. This verifies token costs per phase, checks budget status, and generates required quality notes for final outputs.

What happens if the token-analyzer extension is missing during a workflow run?

If the token-analyzer extension is missing during a workflow run, the system handles the missing data with explicit warnings. It applies guardrails to ensure missing token-analyzer support is reported rather than skipping analysis silently.

How do I record token costs for custom orchestration phases like intake and slicing?

You can record token costs for custom orchestration phases like intake, slicing, scheduling, integration, review, commit, and PR creation by organizing each run with a stable label and capturing phase-by-phase token data.

Does multi-agent planning need run-label normalization for accurate token reporting?

Yes, multi-agent planning requires run-label normalization for accurate token reporting. Normalizing run labels ensures token usage metadata and step records are consistently organized across all Spec Kit and custom orchestration phases.