CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

help

Route a "how do I use Codewhale" question to the installed help, config, and doctor surfaces instead of reciting a manual from memory. Explicit-only.

Quality

90%

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

SKILL.md
Quality
Evals
Security

Quality

Content

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

An exemplary instruction-only skill body: a lean router with a prioritized routing table of exact commands and paths, explicit non-goals, environment branching, and hard bounds against hallucination. Nothing is padded, and every instruction is directly executable.

DimensionReasoningScore

Conciseness

The ~45-line body has no padding and no concepts Claude already knows; every line is a directive or a routing fact ('Prefer its output over inference', 'One surface per question'). The single rationale sentence about prompt budget is load-bearing, matching the 5 anchor ('lean and efficient; every token earns its place').

5 / 5

Actionability

Fully concrete for an instruction-only skill: exact commands ('/help <command>', '/skills inspect', 'codewhale-tui doctor'), exact file paths ('docs/CONFIGURATION.md', 'docs/KEYBINDINGS.md'), exact tool usage ('read' with 'path: "docs/..."'), and explicit negative guidance ('do not invent one', 'do not invent a flag'). Per the scoring notes, the absence of code is not penalized when guidance is this actionable.

5 / 5

Workflow Clarity

The routing table is explicitly prioritized ('in this order', entries 1–5) with per-entry decision guidance, a clear checkout vs. non-checkout branch, and error-recovery bounds ('the surface wins', 'say so and stop'). No destructive or batch operations apply, and the simple-skill exception holds, matching the 5 anchor's clear sequence with error-recovery loops.

5 / 5

Progressive Disclosure

Under 50 lines with no bundle files needed and well-organized sections; the 'docs/*.md' mentions are routing targets rather than skill references and are each one level deep. Per the rubric guideline, an under-50-line skill with no need for external references scores 5 on well-organized sections alone.

5 / 5

Total

20

/

20

Passed

Description

78%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, distinctive description that states a clear routing action with a verbatim natural trigger phrase and an explicit invocation policy. Its main weaknesses are the terse 'Explicit-only' when-clause and missing common trigger variations (commands, settings, keybindings) that the body already names.

Suggestions

Add the common trigger variations users would say — 'commands', 'settings', 'keybindings', 'where a feature lives' — to the description so it matches the body's routing table coverage.

Replace or supplement 'Explicit-only' with a full explicit when-clause, e.g. 'Use when the user explicitly asks how to use Codewhale — a command, setting, keybinding, or where a feature lives.'

DimensionReasoningScore

Specificity

Names the domain ('how do I use Codewhale') and several concrete targets ('help, config, and doctor surfaces') plus an explicit non-goal ('instead of reciting a manual from memory'). Minor gaps remain — the keybindings surface named in the body is absent from the description — so it fits the 4 anchor rather than comprehensive coverage at 5.

4 / 5

Completeness

The 'what' is clear (route how-to-use questions to installed surfaces) and the 'when' is present via 'Explicit-only' plus the embedded trigger phrase, so it clears the 3-cap for missing trigger guidance. It falls short of the 5 anchor because the when-clause is two terse words rather than an explicit 'Use when...' statement with concrete triggers.

4 / 5

Trigger Term Quality

'how do I use Codewhale' is the verbatim natural user phrase, alongside 'help', 'config', and 'doctor'. Common variations a user would also say — 'commands', 'settings', 'keybindings' — appear only in the body, not the description, which fits the 4 anchor ('good keyword coverage; a few natural terms missing') rather than the 5 anchor's synonym coverage.

4 / 5

Distinctiveness Conflict Risk

Scoped to a named-product niche ('how do I use Codewhale') with a verbatim trigger phrase; it serves a clear routing role with minimal overlap risk against any other skill, matching the 5 anchor exactly.

5 / 5

Total

17

/

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

Hmbown/Codewhale

Path

crates/tui/assets/skills/help/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.