About

Imported from sickn33/agentic-awesome-skills (skills/tokenwise/SKILL.md). Install upstream with npx skills add sickn33/agentic-awesome-skills --skill tokenwise. Copyright stays with the author (MIT).

TokenWise — Measurement-Driven Model Router

Name: tokenwise
Author: sickn33

Overview

A Claude Code skill that auto-routes subtasks to the cheapest model that can handle them (Haiku for grunt work, Sonnet for scoped reasoning, Opus only for synthesis), then logs every routed task to a local NDJSON with real token + cost numbers. Includes an A/B test subcommand that runs the same task across multiple tiers and scores quality, so the routing decisions are verified against the user's real workload — not estimated.

Anthropic's own bug tracker (Issue #27665) reports 93.8% of Max-subscriber Claude Code tokens flow to Opus. Existing routers (claude-router, wshobson, VoltAgent) either pin models statically or route by vibes-based heuristics with no measurement. TokenWise fills the measurement gap.

When to use

Cutting Claude Code token spend without sacrificing output quality
Validating whether Haiku/Sonnet is "good enough" for a specific task class before trusting auto-routing
Auditing where Opus tokens are actually being burned
Logging per-session cost data for finance or chargeback

Subcommands

/tokenwise:install — guided installer with diff preview, automatic backups, and --dry-run mode
/tokenwise:report — per-session token + cost summary vs all-Opus baseline
/tokenwise:summary [--week|--month|--all] — historical aggregate with trend
/tokenwise:ab "<task>" — A/B test the same task at multiple tiers, generates a markdown comparison
/tokenwise:undo — restore CLAUDE.md / settings.json from backup

Routing taxonomy

Tier	Model	Task class
Mechanical	Haiku 4.5	file reads, grep, format, rename, simple edits, doc lookups
Scoped reasoning	Sonnet 4.6	single-file refactor, scoped research, test writing
Synthesis	Opus 4.7	architecture decisions, multi-file refactor, security review

Safety caps:

Haiku never spawns further subagents
Max spawn depth = 2
Subagents that need a smarter model return to parent — they never escalate on their own
Tasks under 100 chars with no file context run inline (subagent overhead > savings)
Subagent context >30k tokens bumps a tier

Privacy

Zero telemetry. All logs in .tokenwise/log.ndjson local to the project. Task descriptions truncated to 80 chars and stripped of file contents before logging. No analytics endpoint exists in the source.

Install

In any Claude Code session:

/plugin marketplace add CodeShuX/tokenwise
/plugin install tokenwise@tokenwise

Then run /tokenwise:install and follow the guided prompts.

Limitations

Token counts approximate to ±2% vs Anthropic billing
A/B test mode costs extra tokens (one task × N tiers) — intentional one-time validation
Anthropic-only by design (use LiteLLM or OpenRouter for cross-vendor)
Subagent model: param has known silent-fail bugs on some Claude Code builds — skill probes for this at install and refuses to configure if routing is broken

Source

Repo: https://github.com/CodeShuX/tokenwise
License: MIT
Author: CodeShuX

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/sickn33-agentic-awesome-skills-tokenwise/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

sickn33-agentic-awesome-skills-tokenwise.ocm.jsonjson

{
  "ocm": "1",
  "id": "sickn33-agentic-awesome-skills-tokenwise",
  "kind": "skill",
  "name": "tokenwise",
  "description": "Measurement-driven model router for Claude Code. Routes Haiku/Sonnet/Opus per task class, logs every routed task with real $ numbers, and A/B tests cheaper tiers before you trust the savings.",
  "publisher": "sickn33",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "coding",
      "creative"
    ],
    "tags": [
      "skill-md",
      "model-routing",
      "token-optimization",
      "cost-reduction",
      "anthropic",
      "haiku",
      "sonnet",
      "opus",
      "claude-code",
      "ab-testing"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Measurement-driven model router for Claude Code. Routes Haiku/Sonnet/Opus per task class, logs every routed task with real $ numbers, and A/B tests cheaper tiers before you trust the savings."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/sickn33/agentic-awesome-skills",
      "path": "skills/tokenwise/SKILL.md",
      "ref": "HEAD",
      "url": "https://github.com/sickn33/agentic-awesome-skills/blob/HEAD/skills/tokenwise/SKILL.md",
      "key": "sickn33/agentic-awesome-skills/skills/tokenwise/SKILL.md"
    },
    "license": "MIT"
  },
  "instructions": "# TokenWise — Measurement-Driven Model Router\n\n## Overview\n\nA Claude Code skill that auto-routes subtasks to the cheapest model that can handle them (Haiku for grunt work, Sonnet for scoped reasoning, Opus only for synthesis), then logs every routed task to a local NDJSON with real token + cost numbers. Includes an A/B test subcommand that runs the same task across multiple tiers and scores quality, so the routing decisions are verified against the user's real workload — not estimated.\n\nAnthropic's own bug tracker (Issue #27665) reports 93.8% of Max-subscriber Claude Code tokens flow to Opus. ",
  "cost": {
    "context_tokens": 762
  }
}

Fetch it by URL: GET /api/v1/registry/sickn33-agentic-awesome-skills-tokenwise/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.