CtrlK
BlogDocsLog inGet started
Tessl Logo

functional-area-resolver

Compress an agent's routing file (RESOLVER.md or AGENTS.md) by converting granular skill-per-row tables into functional-area dispatchers. Each area lists sub-skills in a "(dispatcher for: ...)" clause. The LLM reads one area entry and routes to the correct sub-skill. Proven via held-out A/B eval: dispatcher pattern outperforms naive pipe-table compression.

62

Quality

73%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/functional-area-resolver/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

77%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.

The operational core is excellent — a clearly sequenced, fully executable workflow with strong validation gates and feedback loops. The main weakness is token budget: nearly half the body is eval evidence and literature justification inlined in SKILL.md instead of a reference file, plus redundant Contract/Output Format sections.

Suggestions

Move the A/B eval results, reproduce/receipts, methodology caveats, and prior-work citations into a references/ file (e.g. EVAL.md), keeping only a 3–5 line summary with the failure-mode warning in SKILL.md — this addresses both conciseness and progressive disclosure.

Merge the 'Output Format' section into Step 4 (it restates the same template) and delete or drastically shorten the 'Contract' section that self-admittedly 'exists for the conformance test'.

Consolidate scattered version/date references (v0.31.7, v0.32.3.0, 2026-05-11, v0.33.x follow-ups) into a single Changelog/deprecated note so time-sensitive details don't penalize the evergreen instructions.

DimensionReasoningScore

Conciseness

The operational sections (Steps 1–7, Anti-Patterns, Maintenance) are lean, but roughly 40% of the body is A/B eval tables, 'What the data shows', methodology caveats, and a prior-work citations section; the 'Contract' section even states it 'exists for the conformance test' and 'Output Format' restates Step 4. Version numbers and dates (v0.31.7, v0.32.3.0, 2026-05-11, v0.33.x) appear throughout rather than in a deprecated section, which the time-sensitive guideline penalizes. Not 2 because the padding is domain-specific evidence rather than concepts Claude already knows; not 4 because several sections could be cut or trimmed without losing executability.

3 / 5

Actionability

Fully executable throughout: exact commands ('gbrain routing-eval --json', 'node harness.mjs --variants-dir "$TMP" --variants my-edit --model opus --parallel 3 --yes'), a copy-paste area-entry template, concrete thresholds (12KB gate, 95% revert threshold), cost estimates, and a worked before/after example. Placeholders like EDITED and API key are clearly marked.

5 / 5

Workflow Clarity

Steps 1–7 are clearly sequenced with explicit preconditions that refuse to proceed (size gate, clean working tree), two mandatory validation gates, and feedback loops ('If accuracy ... drops below 95%, revert and tune') including a common-causes diagnosis list. The batch/destructive cap does not apply because validation is present and explicit.

5 / 5

Progressive Disclosure

The body is well-sectioned with clear headers and easy navigation, but it is a ~320-line monolith with no bundle files at all: the A/B eval results, reproduce receipts, prior-work citations, and harness internals clearly belong in a one-level-deep reference file. Not 2 because, unlike the anchor-2 example, the structure is genuinely well organized; not 4 because significant content that should be separate is inlined in SKILL.md.

3 / 5

Total

16

/

20

Passed

Description

70%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 specific, well-scoped description that clearly states the transformation mechanism in third person. Its main weakness is the missing 'Use when...' clause, which caps completeness and leaves the trigger terms slightly thinner than the natural phrasings users would actually say.

Suggestions

Add an explicit 'Use when...' clause, e.g. 'Use when the routing file exceeds ~12KB or the user asks to compress/shrink AGENTS.md or RESOLVER.md' — this would lift completeness from 3 toward 5.

Include one or two natural user phrasings as synonyms ('shrink routing table', 'resolver too big') to broaden trigger-term coverage.

Drop or shorten the 'Proven via held-out A/B eval' sentence — evidence claims do not add capability information and pad the description.

DimensionReasoningScore

Specificity

The description lists several concrete, domain-specific actions in third person ('Compress an agent's routing file (RESOLVER.md or AGENTS.md)', 'converting granular skill-per-row tables into functional-area dispatchers', 'lists sub-skills in a "(dispatcher for: ...)" clause'). Not 5 because the final sentences ('Proven via held-out A/B eval...') are justification rather than additional capabilities, so coverage has minor gaps.

4 / 5

Completeness

The 'what' is clearly and concretely answered, but there is no 'Use when...' clause or equivalent explicit trigger guidance in the description, which caps completeness at 3 per the judging guidelines. Not 2 because the 'what' is specific and complete, not vague.

3 / 5

Trigger Term Quality

Good natural-term coverage: 'compress', 'routing file', 'RESOLVER.md', 'AGENTS.md', 'functional-area dispatchers', 'sub-skills'. Not 5 because common user phrasings like 'shrink', 'too big/large', or 'slim down' are absent from the description itself.

4 / 5

Distinctiveness Conflict Risk

Clear niche — compressing routing tables into functional-area dispatchers — with distinct, unambiguous triggers; no realistic overlap with other skill domains.

5 / 5

Total

16

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository
garrytan/gbrain
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.