CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

wayfinder

Plan a huge chunk of work — more than one agent session can hold — as a shared map of decision tickets on your issue tracker, and resolve them one at a time until the way to the destination is clear.

Quality

70%

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

The canonical home for this skill is wayfinder in mattpocock/skills

SKILL.md
Quality
Evals
Security

Quality

Content

75%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 content is a well-organized, highly actionable protocol: concrete templates, exact labels, claim-before-work concurrency guards, and two explicit step-by-step invocation modes with decision branches for edge cases. Its weaknesses are minor — repeated framing phrases, an unexplained research-ticket exception, and reliance on a tracker doc outside this bundle for the physical operations.

Suggestions

Elaborate or remove the research-ticket exception in Invocation ('never resolve more than one ticket per session — with the exception of research tickets') — say how research tickets are resolved within a session, or fold them into the charting flow only.

Trim recurring framing phrases ('one at a time until the way to the destination is clear', 'the edge of the known') that repeat the same idea across the intro, Fog of war, and Out of scope sections.

Define or reference the fallback 'local-markdown tracker' concretely (or via a bundled reference file) so the skill remains executable when no tracker doc is provided.

DimensionReasoningScore

Conciseness

The body is dense and assumes competence — it never explains what an issue tracker or subagent is — but framing phrases repeat across sections ('one at a time until the way to the destination is clear' appears in the intro and Fog of war, 'the edge of the known' / 'edge of the map' recur), so minor trimming is possible. This fits 'efficient; minor instances of over-explanation that could be trimmed' rather than the lean level-5 anchor.

4 / 5

Actionability

Concrete, copy-paste-ready markdown templates for the map and ticket bodies, exact labels ('wayfinder:map', 'wayfinder:<type>'), a claim-by-assignment protocol, and two numbered invocation flows give mostly executable guidance. The gap keeping it below 5: physical tracker operations ('Wayfinding operations') are delegated to a tracker doc that is not part of this bundle, and the fallback 'local-markdown tracker' is named but not specified.

4 / 5

Workflow Clarity

Both invocation modes are clearly sequenced with explicit decision branches (no fog surfaced → stop and ask; mis-scoped ticket → close and move to Out of scope; invalidated decisions → update or delete tickets), and claiming before work guards concurrency. Minor validation gaps remain — 'never resolve more than one ticket per session — with the exception of research tickets' is asserted but the exception is never elaborated in the Work-through-the-map flow.

4 / 5

Progressive Disclosure

A single well-sectioned file with clear headers, and tracker-specific mechanics are correctly delegated outward rather than inlined, keeping the body at low resolution. It is not level 5 because the tracker-doc pointer dangles when no tracker skill is present in the bundle, and the ticket-type and fog-of-war detail, while organized, is all inline in a 120+ line file with no one-level-deep reference split.

4 / 5

Total

16

/

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 states a clear and distinctive capability but reads more like a mission statement than a trigger: it has a clear 'what' with two concrete actions, yet no explicit 'when to use it' clause and few natural user phrasings. Adding a 'Use when...' trigger sentence with everyday terms would lift completeness and trigger-term quality together.

Suggestions

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

Include natural user phrasings as trigger terms — 'too big for one session', 'break this project down', 'plan this out', 'roadmap' — so the skill surfaces when users describe oversized work in their own words.

Enumerate one or two more concrete actions (e.g. 'chart the decision map on the issue tracker, claim and resolve tickets one per session, graduate newly-specified work into fresh tickets') to move specificity from 1-2 actions toward comprehensive coverage.

DimensionReasoningScore

Specificity

The description names its domain (oversized work, issue tracker) and two concrete actions — 'plan... as a shared map of decision tickets on your issue tracker' and 'resolve them one at a time' — which matches the anchor for 1-2 concrete actions without comprehensive coverage. It does not list several specific actions, so it does not fit the level-4 anchor.

3 / 5

Completeness

The 'what' is clearly stated, but there is no explicit 'Use when...' clause or equivalent trigger guidance; 'when' is only weakly implied by 'more than one agent session can hold'. Per the judging guidelines, a missing explicit trigger clause caps completeness at 3.

3 / 5

Trigger Term Quality

'huge chunk of work', 'more than one agent session can hold', and 'issue tracker' are relevant keywords, but the natural phrases a user would actually say ('too big for one session', 'break this down', 'plan this project', 'roadmap') are missing and the language leans metaphorical ('way to the destination'). This sits at 'some relevant keywords but missing common variations', not the good coverage of level 4.

3 / 5

Distinctiveness Conflict Risk

The niche is distinct — planning work that exceeds one agent session as a decision-ticket map on an issue tracker — with only minor overlap risk against generic planning or task-breakdown skills. It is not fully level 5 because it lacks the explicit trigger phrases that would fully separate it from those adjacent 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

phatblat/dotfiles

Path

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