CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ask-matt

Ask which skill or flow fits your situation. A router over the skills in this repo.

52

Quality

66%

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 ./.agents/skills/ask-matt/SKILL.md

The canonical home for this skill is ask-matt in mattpocock/skills

SKILL.md
Quality
Evals
Security

Quality

Content

63%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 body is a well-structured, genuinely useful routing map: every skill is tied to a trigger situation, the main flow is an explicit decision tree with context-window hygiene rules, and guidance is given in concrete commands rather than abstractions. Weaknesses are moderate duplication between the main flow and Standalone sections, an unstated interaction model for the skill itself, and a prominently referenced PHASE-BOUNDARIES.md that is not present in the bundle.

Suggestions

State the skill's own interaction up front — e.g. that when invoked it should ask for (or infer) the user's situation, then recommend a route through this map — so the agent knows what to do, not just what the map contains.

Ship PHASE-BOUNDARIES.md alongside the skill (or inline the five-question tree), since the body leans on it for the one decision it calls the fuzziest.

Deduplicate the /grill-me vs /grill-with-docs comparison — explain the stateless/stateful split once and cross-reference it from the other section to trim roughly a paragraph of repeated reasoning.

DimensionReasoningScore

Conciseness

The map is dense and consistently skill-focused, but the /grill-me vs /grill-with-docs distinction ("stateless", "leaves a paper trail", "strictly the better one") is explained in full twice — once in step 1 of the main flow and again under Standalone — and /wayfinder stacks redundant qualifiers ("it's slower and denser, so save it for exactly that, never a well-scoped feature"). Mostly efficient but with real duplication that could be tightened; not level 4 because the repetition is more than minor.

3 / 5

Actionability

For an instruction-only router this is concrete: exact slash commands per situation, explicit branch questions ("can you settle every question in conversation?", "is this a multi-session build?"), file locations (".scratch/<feature>/issues/"), and a guardrail ("Before stating what a skill does or recommending a step be skipped, read that skill's SKILL.md"). It falls short of 5 because the skill's own behavior when invoked — how the routing conversation with the user proceeds — is never stated.

4 / 5

Workflow Clarity

The main flow is a numbered 1–4 sequence with explicit yes/no branches and context checkpoints ("Keep steps 1–3 in one unbroken context window", compact at the nearest phase boundary near the smart zone). Validation loops are not applicable since this is routing, not a destructive or batch operation. It misses 5 because the phase-boundary decision is admitted as "the fuzziest decision in this whole map" and delegated to an external file rather than resolved inline.

4 / 5

Progressive Disclosure

Sections are well organized (main flow, on-ramps, vocabulary, phase boundaries, standalone) and the single external reference is clearly signaled ("Read [PHASE-BOUNDARIES.md](PHASE-BOUNDARIES.md) for the ordered tree..."), but the bundle contains no such file — no references/, scripts/, or assets/ directories exist — so the one reference is dangling and navigation dead-ends. Good structure, but the broken/absent referenced file keeps this below 4.

3 / 5

Total

14

/

20

Passed

Description

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

The description is concise and honest about the skill's niche — a router over the repo's skills — with a concrete framing action. Its main weakness is the absence of any explicit "Use when..." trigger guidance and thin natural-keyword coverage, leaving the trigger conditions to be inferred. Distinctiveness is good since routing/selection is clearly separated from the skills being routed to.

Suggestions

Add an explicit trigger clause, e.g. "Use when you don't know which skill or flow to start with, or when planning where a piece of work should enter the pipeline."

Include natural trigger phrases users would actually say — "which skill should I use", "where do I start", "what's the workflow for X" — to improve trigger-term coverage.

Briefly name the routing categories (new ideas, bugs, triage, codebase upkeep, big foggy efforts) so the scope of routing is concrete rather than implied by "skills in this repo".

DimensionReasoningScore

Specificity

"A router over the skills in this repo" names the domain and "Ask which skill or flow fits your situation" gives one concrete action, but the description never enumerates the routing situations it covers (ideas, bugs, upkeep, etc.), so coverage is not comprehensive. It is above level 2 because the action stated is concrete rather than generic, and below level 4 because no list of several specific actions appears.

3 / 5

Completeness

The "what" is clear (a router over this repo's skills), but there is no "Use when..." clause or equivalent explicit trigger guidance; the "when" is only weakly implied by "fits your situation". Per the judging guidelines, a missing explicit trigger clause caps completeness at 3.

3 / 5

Trigger Term Quality

The description contains relevant keywords ("skill", "flow", "fits your situation", "router") but misses the natural phrasings a user would actually say, such as "which skill should I use", "where do I start", or "workflow". Level 4 requires good keyword coverage with only a few natural terms missing, which this thin set does not meet.

3 / 5

Distinctiveness Conflict Risk

"A router over the skills in this repo" claims a clear meta-niche distinct from the skills it routes to, with a trigger (choosing between skills) that no individual skill would match. It falls short of level 5 because "Ask which skill or flow fits your situation" is generic enough to overlap with other meta/routing skills.

4 / 5

Total

13

/

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

relative_links

Relative link issues: 1 missing

Warning

Total

15

/

16

Passed

Repository

withcoral/coral

Path

.agents/skills/ask-matt/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.