proskillv2.0.0✓ verified
user-story-writing
How to write user stories and acceptance criteria that are small, testable, and valuable — using INVEST, Given-When-Then, and disciplined story splitting. A deep reference with worked examples and a runnable validator.
$npx vanara install user-story-writing
Included with Vanara Pro ($10/mo) — unlocks all 206 items. See pricing →
Overview
A user story is a promise for a conversation plus a clear definition of done — not a mini-spec. Its job is to capture *who* wants *what* and *why*, small enough to finish in one iteration and verifiable enough that everyone agrees when it is done. This skill is the deep reference: the mental model, the principles, the trade-offs, and the mistakes to avoid. Detailed material lives in references/; c
What it covers
- Write the story in the canonical shape
- Apply INVEST
- Write acceptance criteria as Given-When-Then
- Split stories that are too big
- Add a Definition of Ready and Done
- Acceptance Criteria Patterns
- INVEST — the story quality gate
- Story Splitting Patterns