CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

token-optimizer

Route broad repository discovery to a cheaper worker model using each client's native subagents, keeping the main agent for decisions and targeted verification. Use when asked to "reduce token usage", "delegate bulk reading", "set up a cheap reader agent", or "why is my context filling up".

Quality

81%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

The canonical home for this skill is token-optimizer in nitinjain999/platform-skills

SKILL.md
Quality
Evals
Security

Quality

Content

73%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

Exceptionally actionable and well-sequenced, with validation and recovery loops everywhere they matter — but it is a monolithic ~680-line body whose single external reference (references/token-optimizer.md) does not exist in the bundle, and it carries design-history narration and scattered version pins that inflate length without adding executable value.

Suggestions

Fix the broken reference: the body instructs 'Read `references/token-optimizer.md` before responding' but no references/ directory exists in this bundle — either ship that file or remove the line, since the skill's first navigation step currently fails.

Split the setup-mode machinery (the full jq hook-registration programs, the .token-optimizer.yaml template, probe copy logic) into a reference file such as references/setup.md, keeping SKILL.md as a concise per-mode overview with one-line pointers.

Trim the design-history narratives (e.g. the remove-mode preamble about 'an earlier revision traded one away for the other') down to the operative rule, and centralize version pins (Copilot CLI 1.0.59, v1.41.0, worker model ids) in one place so they can be updated without sweeping the whole document.

DimensionReasoningScore

Conciseness

The body is dense and operational — no basic-concept padding, full commands instead of prose — but it includes several sections of design-history narrative (the remove-mode preamble "an earlier revision traded one away for the other", the step-10b wiring rationale, the step-8 fixture-seeding story) and version pins scattered throughout ("Copilot CLI 1.0.59", "v1.41.0", "claude-sonnet-4.6", "gpt-5.4-mini") that could be tightened or centralized. Not a 2 because nearly all of the length is non-obvious operational detail that earns its tokens; not a 4 because the narrative asides and unpinned-down versions are repeated instances of over-explanation.

3 / 5

Actionability

Fully executable throughout: copy-paste bash for detection and installation, complete jq programs for idempotent hook registration, an awk script for the model rewrite, the exact YAML config template, and literal expected output formats for every mode. This is the anchor-5 case — commands cover the common cases end to end, with nothing left as pseudocode.

5 / 5

Workflow Clarity

Every mode is a numbered sequence ending in an explicit Validation block, ordering constraints are stated with reasons (10b must run after 10; the hash manifest must be written last; directories removed only after all comparisons), and error-recovery feedback loops are present — e.g. an unverified redirect probe falls back to audit, names the command to run, and doctor re-checks it. This matches the anchor-5 example of sequence + explicit validation + recovery loops; the destructive remove mode is heavily validated, so no cap applies.

5 / 5

Progressive Disclosure

Scored against the actual bundle: no references/, scripts/, or assets/ directories exist, yet the body opens with "Read `references/token-optimizer.md` before responding" — a clearly signaled reference to a file that is not in the bundle, so the first navigation step fails outright. On top of that, ~680 lines of setup machinery (full jq registration programs, the config template, probe logic) are inlined monolithically rather than split out, which is the anchor-2 "content that clearly belongs in separate files is inlined" case. Not a 3 because the situation is worse than improvable organization — the one reference the skill points to is missing, breaking navigation rather than merely weakening it; not a 1 because section structure within the body is clear.

2 / 5

Total

15

/

20

Passed

Description

83%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: concrete what, an explicit when-clause with natural quoted trigger phrases, and a distinct niche. The only weaknesses are minor — unmentioned operational modes and a few missing trigger synonyms.

DimensionReasoningScore

Specificity

Concrete, mechanism-level actions are named — "Route broad repository discovery to a cheaper worker model using each client's native subagents" plus "keeping the main agent for decisions and targeted verification" — which goes beyond the anchor-3 pattern of one or two generic actions. It is not a 5: the skill's operational surface (setup, doctor, benchmark, report, remove modes) is entirely unmentioned, a real coverage gap.

4 / 5

Completeness

It explicitly answers both questions: the "what" is stated concretely up front, and the "when" is an explicit "Use when asked to…" clause with concrete trigger phrases, matching the anchor-5 example structure exactly. A missing or implicit trigger clause would cap it at 3; neither applies here.

5 / 5

Trigger Term Quality

Four natural, quoted user phrasings are provided ("reduce token usage", "delegate bulk reading", "set up a cheap reader agent", "why is my context filling up") — good keyword coverage including a question-form trigger. Not a 5: common synonyms like "save tokens", "token cost", or "context window" are missing, so coverage is good rather than comprehensive.

4 / 5

Distinctiveness Conflict Risk

The niche (routing bulk reads to a cheaper worker model) is clear and the triggers are distinctive, but "reduce token usage" is broad enough to overlap with other token- or context-management skills, which is exactly the anchor-4 "minor overlap risk with closely related skills" case. Not a 5 for that overlap; clearly above anchor 3 since the routing/delegation framing is specific rather than generic.

4 / 5

Total

17

/

20

Passed

Validation

81%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (688 lines); consider splitting into references/ and linking

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

13

/

16

Passed

Repository

nitinjain999/platform-skills

Path

plugins/platform-skills/skills/token-optimizer/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.