CtrlK
BlogDocsLog inGet started
Tessl Logo

wayfinder

Plan work too large for one agent session as decision tickets resolved one at a time. Use when the user asks for a multi-session roadmap or long-running plan.

64

Quality

80%

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 body is a well-structured, lean instruction set for a planning skill: clear numbered workflows, named skill invocations, and explicit concurrency/checkpoint guidance. The main gaps are deferred tracker-specific operations and prose that could be marginally tighter.

Suggestions

For actionability, add a short concrete example of the tracker operations (e.g., a sample gh CLI sequence for creating a child issue and wiring blocking) so the deferred tracker-specific steps are executable rather than referenced.

Tighten the metaphor-heavy framing in "Fog of war" and the opening paragraph to lift conciseness toward fully lean prose.

Add an explicit validate-fix-retry checkpoint for issue mutation under concurrent sessions (e.g., re-read the map after claiming, abort if the frontier changed) to push workflow clarity higher.

DimensionReasoningScore

Conciseness

The body is dense, skill-specific doctrine with no padding of concepts Claude already knows (no explanation of issue trackers or planning basics), matching score 4; it stops short of score 5 because some metaphor-heavy prose ("fog of war", "chart the way") could be tightened, and is above score 3 because almost every section earns its place with non-obvious wayfinder-specific rules.

4 / 5

Actionability

Provides concrete numbered steps, named skills to invoke (/grilling, /domain-modeling, /research), and specific labels (wayfinder:map, wayfinder:<type>), matching score 4; it does not reach score 5 because tracker-specific operations are deferred to an external tracker doc rather than given as executable commands, and it is above score 3 because the guidance is largely directly executable rather than pseudocode.

4 / 5

Workflow Clarity

Both invocation modes have clear numbered sequences with checkpoints (claim-before-work, the no-fog stop condition, the rule-out-of-scope recovery loop), matching score 4; it does not reach score 5 because some validation for the concurrency/issue-mutation operations is implicit rather than an explicit validate-fix-retry loop, and it is above score 3 because explicit checkpoints and recovery steps are present.

4 / 5

Progressive Disclosure

A single self-contained file with well-organized section headers and clear internal navigation, no bundle files needed, matching score 4; it does not reach score 5 because there are no one-level-deep references to split out (the anchor rewards a clear overview pointing to detail files), and it is above score 3 because structure is clean and content is appropriately placed rather than inlined where it does not belong.

4 / 5

Total

16

/

20

Passed

Description

78%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 clearly states both the capability and an explicit trigger condition in third person, with natural trigger terms and a distinct niche. Its weakest area is specificity, where the mechanism is named but not unpacked into multiple concrete actions.

Suggestions

Enumerate 1-2 more concrete actions (e.g., 'chart a shared map on the issue tracker, then work decision tickets one at a time') to lift specificity from naming the mechanism to listing concrete actions.

Add a couple of trigger synonyms (e.g., 'long-running plan', 'multi-step roadmap', 'effort too big for one session') to broaden natural keyword coverage.

DimensionReasoningScore

Specificity

Names the domain and the core mechanism ("Plan work too large for one agent session as decision tickets resolved one at a time") but lists only 1-2 concrete actions and is not comprehensive, matching the score-3 anchor; it does not reach score 4 because multiple distinct concrete actions are not enumerated, and it is above score 2 because the action is specific rather than generic.

3 / 5

Completeness

Explicitly answers both what ("Plan work too large for one agent session as decision tickets resolved one at a time") and when ("Use when the user asks for a multi-session roadmap or long-running plan") with concrete trigger phrases, matching the score-5 anchor; it is below no neighboring anchor since both halves are explicit.

5 / 5

Trigger Term Quality

Includes natural phrases a user would say ("multi-session roadmap", "long-running plan") with good coverage, fitting the score-4 anchor; it stops short of score 5 because synonyms and varied phrasings are limited, and is above score 3 because the terms are natural rather than jargon-only.

4 / 5

Distinctiveness Conflict Risk

The multi-session decision-ticket framing is a clear, distinct niche with minor overlap risk against general planning skills, matching score 4; it does not reach score 5 because "plan" and "roadmap" are broad enough to overlap with adjacent planning skills, and is above score 3 because the decision-ticket mechanic narrows it notably.

4 / 5

Total

16

/

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
EpicenterHQ/epicenter
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.