CtrlK
BlogDocsLog inGet started
Tessl Logo

wayfinder

把单个 agent session 装不下的一大块工作规划成 issue tracker 上的 decision tickets shared map,并逐一解决,直到通往 destination 的路清晰。

55

Quality

63%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./skills/engineering/wayfinder/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

67%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 orchestration skill: both invocation modes are precisely sequenced with concrete templates, labels, claim/blocking protocols, and explicit stop conditions. Its main weakness is token efficiency — a layer of conceptual narration and justification could be trimmed — and a few operational details (tracker fallback, resolution-comment content) are deferred without being pinned down.

Suggestions

Trim the justificatory musing (e.g. the "Plan, don't do" and fog-of-war framing sentences) to bare rules; keep the rules, drop the philosophy.

Add one or two concrete lines specifying what a resolution comment must contain (answer, evidence/links, facts downstream tickets depend on), since the work-through flow depends on it.

Add a brief validation step after wiring blocking edges (e.g. re-run the frontier query and confirm each blocked ticket shows its blocker), closing the one remaining workflow gap.

DimensionReasoningScore

Conciseness

The body is mostly efficient, skill-specific rules, but recurring conceptual musing — "Wayfinding 的目标是找到这条路,而不是朝 destination 猛冲", "想直接做工作的冲动通常表示你已经到达 map 边缘", "Out-of-scope work 永远不会 graduate;frontier 会停在 destination" — justifies rules rather than stating them and could be tightened without losing clarity.

3 / 5

Actionability

Concrete, executable guidance throughout: numbered steps with exact sub-skill invocations ("调用两次 Skill 工具,分别指定 `grilling` 和 `domain-modeling`"), ready-to-use map and ticket body templates, specific labels (`wayfinder:map`, `wayfinder:<type>`), and a precise claim protocol ("在任何工作开始前先 assign"). Minor gaps: the local-markdown tracker fallback and the expected content of a resolution comment are left unspecified.

4 / 5

Workflow Clarity

Both invocation modes are clearly sequenced with numbered steps and several explicit checkpoints ("如果没有 fog…停止并询问用户如何继续", "停止。Charting 是一个 session 的工作", "每个 session 绝不要 resolve 超过一个 ticket") plus feedback handling ("如果这个 decision 使 map 其他部分失效,更新或删除那些 tickets"). Not 5 because there is no validate/retry loop on tracker edits, e.g. confirming blocking edges wired correctly after the second pass.

4 / 5

Progressive Disclosure

No bundle files exist, so everything lives in a single well-sectioned SKILL.md (Map, Ticket Types, Fog of war, Out of scope, Invocation) with templates placed at point of use and one clearly signaled external pointer ("查阅 tracker doc 的 'Wayfinding operations' section"). Good structure with no nested references; the only gap is that all detail is inlined in a ~123-line file, though nothing here demands a split.

4 / 5

Total

15

/

20

Passed

Description

58%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 states a concrete and distinctive mechanism (decompose oversized work into decision tickets on an issue tracker and resolve them until the path is clear), but it never tells Claude when to reach for it. Adding an explicit trigger clause with natural synonyms would lift both completeness and trigger-term quality.

Suggestions

Add an explicit 'when' clause, e.g. 'Use when a task is too large for one agent session, when the user asks to break down or plan a big effort, or when the path to a goal is unclear.'

Include natural trigger synonyms such as 'break down work', 'too big for one session', 'plan a large effort', and 'roadmap' alongside the existing 'issue tracker' phrasing.

Briefly name the two invocation modes (charting a map vs. working through an existing map) so the description covers the skill's full capability surface.

DimensionReasoningScore

Specificity

"规划成 issue tracker 上的 decision tickets shared map" and "并逐一解决,直到通往 destination 的路清晰" name concrete, mechanism-level actions (decompose into decision tickets, resolve sequentially to a path-clear criterion), but coverage of the skill's full surface (charting vs. working modes, ticket types) is incomplete.

4 / 5

Completeness

The 'what' is clearly stated ("规划成…shared map,并逐一解决"), but there is no 'Use when…' clause or equivalent explicit trigger guidance — the triggering condition (work too large for one session) appears only as a property of the target work, so 'when' is at best weakly implied, which caps this at 3.

3 / 5

Trigger Term Quality

"单个 agent session 装不下" and "issue tracker" are natural user phrases, but common variations users would actually say ("break down this work", "too big", "plan this", "spec", "roadmap") are missing.

3 / 5

Distinctiveness Conflict Risk

"decision tickets shared map" carves a distinct issue-tracker-based wayfinding niche with low conflict risk, though the broader planning/spec-writing space is crowded, so minor overlap risk remains.

4 / 5

Total

14

/

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.