Content
75%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-crafted, domain-specific instruction skill: prescriptive structure, concrete deliverable templates, a clearly sequenced workflow with user validation, and a valuable failure-patterns section, supported by a real one-level-deep reference file. The main gaps are mild redundancy with the reference template, a few glosses of research methods Claude already knows, and workflow validation steps that lack explicit error-recovery branches.
Suggestions
Move the inline markdown output template (or a trimmed skeleton of it) into references/journey-map-template.md to eliminate duplication with the existing fillable template and shorten SKILL.md.
Add an explicit error-recovery branch to the workflow — e.g., after step 7 (validate with users), state what to revise and re-check when validation contradicts the draft map — to strengthen the feedback loop.
Trim glosses of methods Claude already knows (e.g., "Surveys. Quantitative signal at scale; less depth." and the diary-study definition) and the illustrative "shipping is slow" aside.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is largely prescriptive rather than educational — the lane taxonomy, phase templates, failure patterns, and output template all specify what to do rather than explain background. Minor over-explanation could be trimmed: glosses of methods Claude already knows ("Surveys. Quantitative signal at scale; less depth.", "Diary studies. Users log their experience over the duration of the journey.") and the illustrative aside about "shipping is slow" tracing to a vendor handoff. This fits "Efficient; minor instances of over-explanation that could be trimmed" — not level 5 ("every token earns its place") nor level 3 ("some unnecessary explanation", which would imply more substantial padding). | 4 / 5 |
Actionability | As an instruction-only skill, it provides a copy-paste-adaptable markdown output template covering journey map, service blueprint additions, and opportunity map, plus a 10-step workflow and concrete failure patterns — this meets "Mostly executable guidance... with minor gaps". It falls short of level 5 ("copy-paste ready code or commands; specific examples cover the common cases") because several workflow steps remain guidance-level (e.g., "Identify opportunities. Use the friction points and disconnects.") without criteria or worked examples, and no filled-in example map is provided. | 4 / 5 |
Workflow Clarity | The 10-step workflow is clearly sequenced (scope → gather → draft → layer → blueprint → opportunities → validate → workshop → action → maintain) with a validation checkpoint at step 7 ("Validate with users. Does this match their actual experience? Refine.") and cross-validation of user/business/internal views. This matches "Clear sequence with most checkpoints present; minor validation gaps". It is not level 5 because the feedback loop lacks an explicit error-recovery branch — what to change and re-check when validation contradicts the draft — and there is no checklist for such a long process; it is well above level 3, where checkpoints would be merely implicit (the destructive/batch cap does not apply to this non-destructive research skill). | 4 / 5 |
Progressive Disclosure | The body is well-sectioned (When to use / NOT to use, Required inputs, framework, phases, inputs, workflow, failure patterns, output format) with one clearly signaled, one-level-deep reference — [references/journey-map-template.md], verified to exist and to match its described purpose ("Fillable journey map and service blueprint template"). This fits "Good structure; most content is appropriately placed; references mostly clear; minor organization gaps". It is not level 5 because the ~40-line inline output template (lines 196–238) substantially duplicates the reference template and arguably belongs there, and the SKILL.md at ~240 lines leans toward being a full manual rather than an overview pointing to detailed materials; it is well above level 3, since structure and reference signaling are genuinely good. | 4 / 5 |
Total | 16 / 20 Passed |