CtrlK
BlogDocsLog inGet started
Tessl Logo

ask-matt

询问当前情境适合哪个技能或流程;它是本仓库所有 skills 的路由器。

48

Quality

53%

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/engineering/ask-matt/SKILL.md
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-organized routing map with genuinely concrete decision guidance and clearly sequenced flows — as an instruction-only skill its actionability is strong. Its main weaknesses are a broken reference to a nonexistent PHASE-BOUNDARIES.md (the one place a reader is directed for the hardest decision) and repetitive cross-section explanation that inflates token cost.

Suggestions

Fix or remove the broken [PHASE-BOUNDARIES.md](PHASE-BOUNDARIES.md) reference — either ship the file (five questions and the branch rationale, as promised) or inline a condensed version, since it currently points readers to nothing.

Deduplicate the grill-with-docs vs. grill-me comparison (currently explained in main flow step 1, Standalone, and Vocabulary) — state the rule once and cross-reference it.

Move the longer per-skill rationale in Standalone (e.g. /prototype, /wizard entries) into a reference file, keeping SKILL.md to one-line routing rules with pointers.

DimensionReasoningScore

Conciseness

The body is dense and mostly earns its tokens (per-skill routing rules, decision branches), but the grill-with-docs vs. grill-me distinction is explained three separate times (main flow step 1, Standalone, Vocabulary), the /handoff usage is spelled out in both the main flow and Phase boundaries, and several entries carry rationale that could be trimmed — 'mostly efficient but could be tightened'. Not a 4 because the repetition across sections is noticeable rather than minor.

3 / 5

Actionability

As an instruction-only skill it gives concrete, specific guidance: named slash commands for every branch, binary decision questions ("能否在对话中解决所有问题?"、"这是 multi-session build 吗?"), and concrete paths and locations (`.scratch/<feature>/issues/`、`prototype/<name>`、`.env` and GitHub secrets). Not a 5 because some routing criteria remain judgment calls (e.g. when an effort is '巨大而模糊') without a tie-breaker.

4 / 5

Workflow Clarity

The main flow is a clearly sequenced decision tree (idea -> grill -> branch on prototype/multi-session -> tickets -> implement -> review) with explicit checkpoints such as the context-hygiene rule (one unbroken window through /to-tickets) and the smart-zone compact guidance. No destructive or batch operations are involved, so the validation-loop cap does not apply; not a 5 because the phase-boundary decision tree itself is acknowledged as ambiguous and deferred to a missing file.

4 / 5

Progressive Disclosure

Section structure is good (main flow, on-ramps, codebase health, vocabulary, phase boundaries, standalone, precondition), but the body's only bundle reference — [PHASE-BOUNDARIES.md](PHASE-BOUNDARIES.md) — points to a file that does not exist in the bundle (no references/ directory, no such file), and substantial per-skill detail in Standalone/Vocabulary is inlined that could live in reference files. Not a 4 primarily because the one reference offered is broken, leaving a whole promised topic undeliverable.

3 / 5

Total

14

/

20

Passed

Description

42%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 communicates a clear and specific purpose (a router that asks which skill or flow fits the current situation), but it lacks any explicit trigger guidance and offers almost no natural keywords a user would say. As a router-style description it works for humans browsing the repo, yet it reads as a label rather than a capability-and-trigger statement.

Suggestions

Add an explicit trigger clause, e.g. "不知道该用哪个 skill、不确定下一步流程、或需要在多个 skills 之间做选择时使用" — this would lift both completeness and trigger-term quality.

Enumerate 2-3 concrete capabilities beyond routing, such as "描述当前情境并推荐入口 skill、解释 main flow 与 on-ramps 的关系、指向 precondition 设置".

Include natural user phrasings/synonyms ("用哪个技能"、"下一步该做什么"、"which skill"、"next step") so the description matches how users actually ask.

DimensionReasoningScore

Specificity

The description names its domain ("本仓库所有 skills" 的路由) and one concrete action ("询问当前情境适合哪个技能或流程"), but stops there — it lists no further capabilities, so it matches 'names domain and 1-2 concrete actions, but not comprehensive'. It is not a 4 because coverage consists of a single routing action rather than several specific actions.

3 / 5

Completeness

The "what" is clear (asks which skill or flow fits the current situation; router for all skills in this repo), but there is no "use when" clause or equivalent trigger guidance anywhere — per the judging guidelines this caps completeness at 3. It is not a 2 because the "what" half is specific, not vague.

3 / 5

Trigger Term Quality

The only keywords are the generic "技能", "流程", and "路由器" — one or two generic terms with none of the natural phrases a user would actually say (e.g. "该用哪个 skill"、"which skill should I use"), matching 'one or two generic keywords; missing the natural phrases users say'. It is not a 3 because no relevant synonyms or variations appear at all.

2 / 5

Distinctiveness Conflict Risk

The router framing ("它是本仓库所有 skills 的路由器") gives it a distinct purpose, but by definition it claims relevance to every other skill in the repo, so overlap risk with similar meta/navigation skills remains — 'somewhat specific but could still overlap'. It is not a 4 because the scope is explicitly all skills, not a narrow niche with distinct triggers.

3 / 5

Total

11

/

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
vinvcn/mattpocock-skills-zh-CN
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.