CtrlK
BlogDocsLog inGet started
Tessl Logo

user-story-mapping

Create a user story map that lays out activities, steps, tasks, and release slices. Use when planning a workflow, backlog, or MVP around the user journey.

62

Quality

73%

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/user-story-mapping/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 content is a well-structured, actionable walk-through with clear sequencing and quality checks, but it carries redundancy that a leaner version would cut and leans on referenced files (template.md, examples/sample.md) that do not exist in the bundle.

Suggestions

Remove the redundant "Purpose" section and the duplicate Story Map Structure block; keep only the ASCII diagram or the labeled version to reduce token weight.

Add the missing `template.md` and `examples/sample.md` files to the bundle, or inline the template content so the references in Steps 1 and Examples resolve.

Tighten the Anti-Patterns / "When NOT to Use" material into a single concise list to avoid re-explaining concepts Claude already understands.

DimensionReasoningScore

Conciseness

The body is mostly efficient but includes padded explanatory material Claude already knows — a redundant "Purpose" that restates the intent, an ASCII diagram plus a separate labeled structure block conveying the same hierarchy, and an Anti-Patterns list that re-explains what the map is not.

3 / 5

Actionability

Each step provides concrete fill-in templates and worked examples (e.g., the Sarah persona, invoice tasks), giving mostly executable guidance; the templates are placeholders rather than fully copy-paste artifacts, a minor gap.

4 / 5

Workflow Clarity

Seven steps are clearly sequenced with per-step quality checks acting as checkpoints; Step 7 adds a review/verification loop for gaps, though there is no explicit rework feedback cycle after the gap review.

4 / 5

Progressive Disclosure

The body references bundle files (`template.md`, `examples/sample.md`) that are not present in the bundle, so the "one level deep" pointers do not resolve; structural organization is otherwise reasonable but the broken references weaken navigation.

3 / 5

Total

14

/

20

Passed

Description

83%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 cleanly answers both what the skill produces and when to invoke it, using a concrete third-person action verb and explicit trigger guidance. It is a strong, well-targeted description with only minor synonym-coverage gaps.

DimensionReasoningScore

Specificity

Lists several concrete actions — "lays out activities, steps, tasks, and release slices" — naming the core deliverables of the artifact, though it stops short of describing the inputs it processes.

4 / 5

Completeness

It states both what it does ("Create a user story map that lays out activities, steps, tasks, and release slices") and an explicit "Use when..." trigger clause ("Use when planning a workflow, backlog, or MVP around the user journey"), matching the 5-anchor pattern.

5 / 5

Trigger Term Quality

Natural planning phrases are present ("planning a workflow, backlog, or MVP around the user journey"), covering the common ways a user would request this, but it omits a few synonyms like "user story map" or "release slicing."

4 / 5

Distinctiveness Conflict Risk

The "user story map" framing carves a distinct niche from adjacent PM skills, with minor overlap risk against generic backlog or roadmap skills; it is mostly distinct rather than wholly unique.

4 / 5

Total

17

/

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.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository
deanpeters/Product-Manager-Skills
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.