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.