CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

user-story-splitting

Break a large story or epic into smaller deliverable stories using proven split patterns. Use when backlog items are too big for estimation, sequencing, or independent release.

Quality

75%

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 ./plugins/sdlc/skills/user-story-splitting/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

70%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, genuinely actionable instruction skill: the 8-pattern catalog with worked examples and the validate-and-revise loop are strong. Its weaknesses are padded background sections Claude doesn't need and a broken progressive-disclosure layer that points to template and example files that aren't in the bundle.

Suggestions

Delete the 'Why Split Stories?' section, the 'Dean's Work' section, and the footer metadata block ('Suggested filename', 'Suggested placement'), and deduplicate the Purpose paragraph against the frontmatter intent — Claude already knows the benefits of small stories.

Either add the referenced bundle files (template.md, examples/sample.md) or inline the essential template content and remove the dangling references so navigation doesn't break.

Move the eight fully worked pattern examples into a single examples reference file, keeping one compact example per pattern inline in SKILL.md.

DimensionReasoningScore

Conciseness

The Application section is example-driven and efficient, but several padded sections explain things Claude already knows: 'Why Split Stories?' (faster feedback, reduced risk), the Purpose paragraph that duplicates the frontmatter intent verbatim, the 'Dean's Work' section, and the footer metadata ('Suggested filename', 'Suggested placement'). Fits anchor 3 (mostly efficient with some unnecessary explanation) rather than 2 because the pattern catalog and split examples are dense with useful signal.

3 / 5

Actionability

Each pattern has a concrete 'Ask' question plus before/after split examples, Step 3 provides a fill-in output template, and Step 4 a five-question validation checklist — mostly executable guidance. Minor gap: Step 2 defers 'the full fill-in structure and output format' to a template.md that is not present in the bundle, so it falls short of anchor 5's fully copy-paste-ready coverage.

4 / 5

Workflow Clarity

A clear four-step sequence with patterns applied in order and an explicit stop condition ('Stop when you find one that applies'), ending in a validation checklist with a feedback loop ('If any answer is "no," revise.'). This matches anchor 5: clear sequence, explicit validation steps, and an error-recovery loop.

5 / 5

Progressive Disclosure

Section structure is good and references are clearly signaled, but the referenced files — template.md, examples/sample.md, and skills/user-story/SKILL.md — do not exist in the bundle (no references/, scripts/, or assets/ directories), so navigation breaks. The eight fully worked pattern examples also could live in a reference file to slim the main body. Fits anchor 3 (some structure, organizational gaps around references) rather than 4.

3 / 5

Total

15

/

20

Passed

Description

70%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.

A solid description with an explicit what/when structure and natural agile trigger terms. Its main gaps are the generic 'proven split patterns' phrase (the concrete patterns aren't named) and trigger phrasing based on item state rather than what a user would actually say or ask for.

Suggestions

Replace the generic 'using proven split patterns' with one or two named patterns or a concrete capability, e.g. 'Break a large story or epic into smaller deliverable stories using 8 splitting patterns (workflow steps, business rules, data variations...).'

Add user-utterance triggers to the when-clause, e.g. 'Use when the user asks to split, break down, or decompose a story or epic, or when a user story is too big for a sprint.'

Include the common synonyms 'user story', 'split', and 'break down' to widen natural keyword coverage.

DimensionReasoningScore

Specificity

Names the domain ('a large story or epic') and one concrete action ('break into smaller deliverable stories'), but 'using proven split patterns' is generic — the actual patterns aren't enumerated. This matches anchor 3 (domain plus 1-2 concrete actions, not comprehensive) rather than 4, which requires several specific actions listed.

3 / 5

Completeness

Explicitly answers both: what ('Break a large story or epic into smaller deliverable stories using proven split patterns') and when ('Use when backlog items are too big for estimation, sequencing, or independent release'). The trigger is condition-based rather than user-utterance-based ('when the user asks to split a story'), so it fits anchor 4 rather than 5's concrete user trigger phrases.

4 / 5

Trigger Term Quality

Contains natural terms a user would say: 'story', 'epic', 'backlog items', 'too big', 'estimation', 'independent release'. Good keyword coverage, but misses common variations like 'user story', 'split', 'break down', and 'sprint', so it falls short of anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

Clear niche (story/epic splitting) that is easily distinguishable from most skills. Minor overlap risk with adjacent story-writing and estimation skills — 'too big for estimation' could bleed into an estimation skill — so anchor 4 rather than 5.

4 / 5

Total

15

/

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

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

whimzyLive/nightshift-ai

Path

plugins/sdlc/skills/user-story-splitting/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.