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.

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.

A well-structured, opinionated routing map with genuinely actionable decision rules and concrete conventions. Its weaknesses are repetitious and aside-heavy prose that could be tightened, and a single clearly-signaled reference (PHASE-BOUNDARIES.md) that is missing from the bundle, leaving the deepest decision tree undeliverable.

Suggestions

Ship PHASE-BOUNDARIES.md in the bundle (e.g. under references/) so the only deep-dive link in the body is not dangling.

Cut the duplicated grill-with-docs vs. grill-me comparison - keep the one-line rule in the main flow step 1 and let the Standalone section carry the full rationale (or vice versa).

Trim nested parenthetical asides in the main-flow steps and the wayfinder paragraph into their own short sentences or a comparison table to reduce token load without losing the decision content.

DimensionReasoningScore

Conciseness

The body assumes intelligence (no basic-concept explanations) and is dense, but several passages could be tightened: the grill-with-docs vs. grill-me comparison appears in both the main-flow step 1 parenthetical and the Standalone section, the wayfinder paragraph is very long, and many sentences carry multiple nested parenthetical asides ('(a prototype lives in its own directory, which is exactly what /handoff is for; see Phase boundaries)'). This matches 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than the minor-trimming of anchor 4.

3 / 5

Actionability

For an instruction-only routing skill, the guidance is concrete: explicit branch conditions ('can you settle every question in conversation?', 'is this a multi-session build?'), concrete paths and conventions ('.scratch/<feature>/issues/', 'prototype/<name> branch out of main', 'keep steps 1-3 in one unbroken context window'), and named commands per situation. Per the scoring notes, absence of code is not penalized when guidance is actionable; minor gaps (e.g. no example of what a decision ticket looks like) keep it below 5.

4 / 5

Workflow Clarity

The main flow is a numbered, explicitly-branched sequence with context-hygiene rules and named handoff points, and the on-ramps each state when to enter and where they merge. There are no validation checkpoints, but the skill is a read-only router with no destructive or batch operations, so the workflow-clarity cap does not apply; minor gaps (e.g. no explicit recovery path if a detour prototype fails to settle the question) keep it at anchor 4.

4 / 5

Progressive Disclosure

Section structure is clear (main flow, on-ramps, vocabulary, phase boundaries, standalone), and the one deep-dive topic is offloaded via a clearly signaled link ('Read PHASE-BOUNDARIES.md for the ordered tree'). However, that referenced file does not exist in the bundle (no references/ directory, no PHASE-BOUNDARIES.md alongside SKILL.md), making the only progressive-disclosure reference dangling. Structure exists but the bundle-level reference integrity is broken, which fits anchor 3 better than 4's 'references mostly clear' with intact organization.

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, third-person, and carves a distinct niche as a skill router, but it lacks an explicit 'Use when...' trigger clause and natural trigger synonyms. It states one concrete action clearly, which keeps it above vague-fluff territory but below the comprehensive good examples.

Suggestions

Add an explicit trigger clause, e.g. 'Use when you don't know which skill to reach for, or when choosing between skills/flows for a task.'

Include natural user phrasings and synonyms such as 'which skill should I use', 'routing', 'picking the right flow', or 'what tool fits this task'.

Optionally enumerate one or two concrete routing behaviors (e.g. 'Maps idea-to-ship builds, bug triage, and merge-conflict situations to the right skill') to lift specificity.

DimensionReasoningScore

Specificity

The description names the domain ('A router over the skills in this repo') and one concrete action ('Ask which skill or flow fits your situation'), matching the anchor for 1-2 concrete actions without comprehensive coverage. It does not reach 4 because no additional capabilities (routing rules, on-ramps, skill lookup) are listed; it is not 2 because a concrete routing action is stated rather than generic processing.

3 / 5

Completeness

The 'what' is clear (a router over the repo's skills), but there is no explicit 'Use when...' clause or equivalent 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, and anchor 3 ('clear what but when only weakly implied') is the best fit.

3 / 5

Trigger Term Quality

'fits your situation' and 'skill or flow' are natural phrases a user might say, but there are no synonyms or scenario keywords ('which skill should I use', 'routing', 'what tool for this task'). This matches 'some relevant keywords but missing common variations or synonyms' rather than the good coverage of anchor 4.

3 / 5

Distinctiveness Conflict Risk

'A router over the skills in this repo' carves out a clear niche (meta-routing over this repo's skill set) with minimal overlap risk against content-level skills. It is not 5 because 'fits your situation' is somewhat generic and could mildly overlap with other advisory/router-style 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

tonykay/transcriber

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.