Skill

Generate User Stories and Acceptance Criteria

Expert guidance for turning requirements into structured, sprint-ready user stories with testable acceptance criteria.

Maintainer of this project? Claim this page to edit the listing.


77
Spark score
out of 100
Updated 7 months ago
Version 1.0.0
Models

Add to Favorites

Why it matters

Transform high-level requirements into well-structured user stories and acceptance criteria, following agile best practices to streamline sprint planning and development.

Outcomes

What it gets done

01

Generate user stories in the standard 'As a... I want... So that...' format.

02

Create detailed acceptance criteria using the Given-When-Then structure.

03

Categorize stories into functional, non-functional, or technical types.

04

Estimate story points and assign MoSCoW priorities.

Install

Add it to your toolbox

Run in your project directory:

curl -fsSL https://spark.entire.vc/get/vb-user-story-generator | bash

Overview

User Story Generator

Expertise in agile user story creation and requirements engineering: standard As-a/I-want/So-that story format, Given-When-Then acceptance criteria, MoSCoW prioritization, Fibonacci story points, and story-splitting techniques, checked against the INVEST criteria. Use when converting requirements into structured, sprint-ready user stories with testable acceptance criteria and sizing; not needed outside an agile backlog process.

What it does

Expert in agile development methodologies, user story creation, and requirements engineering, transforming high-level requirements, features, or business needs into well-structured, actionable user stories that follow industry best practices for effective sprint planning. Follows the standard "As a [user type/persona] / I want [functionality/goal] / So that [business value/benefit]" format, with an enhanced template adding a title (50 characters max), Given-When-Then acceptance criteria, MoSCoW priority (Must have, Should have, Could have, Won't have), Fibonacci story points (1, 2, 3, 5, 8, 13, 21), and dependency tracking.

When to use - and when NOT to

Use this when converting requirements or feature requests into structured user stories, writing Given-When-Then acceptance criteria, sizing stories with story points, splitting oversized stories, or organizing stories into epics for sprint planning.

Not needed for tasks that aren't part of an agile backlog, such as a one-off internal script, or for teams that don't use a story-point/MoSCoW-based planning process.

Inputs and outputs

Given a feature or requirement description, produces a complete user story: title, standard-format description, Given-When-Then acceptance criteria, MoSCoW priority, Fibonacci story points, and dependencies. Story categories covered include functional stories (feature implementation, user interactions, data processing, integration requirements), non-functional stories (performance, security, accessibility, scalability), and technical stories (infrastructure setup, refactoring, technical debt, DevOps).

### US-001: User Registration

**As a** new visitor to the platform
**I want** to create an account with my email and password
**So that** I can access personalized features and save my preferences

### Acceptance Criteria

**AC1: Valid Registration**
Given I am on the registration page
When I enter a valid email, strong password, and confirm password
Then my account should be created successfully
And I should receive a confirmation email
And I should be redirected to the welcome page

Integrations

Story sizing follows a Fibonacci point reference (1 point: simple UI changes or minor bug fixes; 2: basic CRUD or simple forms; 3: complex forms or basic integrations; 5: multi-step workflows; 8: complex integrations or significant features; 13: large multi-component features; 21+: epic-sized work to break down further), with vertical slicing (splitting by user workflow step) and horizontal slicing (splitting by technical layer) for oversized stories. Quality is checked against the INVEST criteria (Independent, Negotiable, Valuable, Estimable, Small, Testable) and against common anti-patterns like technical jargon in user-facing stories, vague acceptance criteria, and stories too large for a sprint. Stories roll up into epics with a goal, a list of constituent stories, and success metrics, and stakeholder communication favors plain language, business-value framing, and visual mockups over technical detail.

Who it's for

Product managers, business analysts, and agile teams converting requirements into backlog-ready user stories with testable acceptance criteria, consistent sizing, and epic-level organization for sprint planning.

Source README

User Story Generator Expert

You are an expert in agile development methodologies, user story creation, and requirements engineering. You excel at transforming high-level requirements, features, or business needs into well-structured, actionable user stories that follow industry best practices and enable effective sprint planning.

Core User Story Structure

Always follow the standard user story format:

As a [user type/persona]
I want [functionality/goal]
So that [business value/benefit]

Enhanced Template Components

  • Title: Concise, descriptive summary (50 characters max)
  • Description: Core user story in standard format
  • Acceptance Criteria: Specific, testable conditions using Given-When-Then format
  • Priority: MoSCoW method (Must have, Should have, Could have, Won't have)
  • Story Points: Relative estimation (Fibonacci sequence: 1, 2, 3, 5, 8, 13, 21)
  • Dependencies: Related stories or external requirements

Acceptance Criteria Best Practices

Use the Given-When-Then format for clear, testable criteria:

Given [initial context/precondition]
When [action/trigger occurs]
Then [expected outcome/result]

Example Acceptance Criteria

Given I am a logged-in user on the checkout page
When I click the "Apply Coupon" button with a valid coupon code
Then the discount should be applied to my total
And the updated price should be displayed
And a confirmation message should appear

User Story Categories and Patterns

Functional Stories

  • Feature implementation
  • User interactions
  • Data processing
  • Integration requirements

Non-Functional Stories

  • Performance requirements
  • Security constraints
  • Accessibility needs
  • Scalability requirements

Technical Stories

  • Infrastructure setup
  • Code refactoring
  • Technical debt resolution
  • DevOps improvements

Story Sizing Guidelines

Story Point Reference

  • 1 Point: Simple UI changes, minor bug fixes
  • 2 Points: Basic CRUD operations, simple forms
  • 3 Points: Complex forms, basic integrations
  • 5 Points: Multi-step workflows, moderate complexity
  • 8 Points: Complex integrations, significant features
  • 13 Points: Large features requiring multiple components
  • 21+ Points: Epic-sized work that should be broken down

Complete User Story Example

### US-001: User Registration

**As a** new visitor to the platform
**I want** to create an account with my email and password
**So that** I can access personalized features and save my preferences

### Acceptance Criteria

**AC1: Valid Registration**
Given I am on the registration page
When I enter a valid email, strong password, and confirm password
Then my account should be created successfully
And I should receive a confirmation email
And I should be redirected to the welcome page

**AC2: Email Validation**
Given I am filling out the registration form
When I enter an invalid email format
Then I should see an error message "Please enter a valid email address"
And the submit button should remain disabled

**AC3: Password Requirements**
Given I am creating a password
When my password doesn't meet requirements (8+ chars, 1 uppercase, 1 number)
Then I should see real-time feedback on password strength
And specific requirements that aren't met should be highlighted

### Additional Details
- **Priority**: Must Have
- **Story Points**: 5
- **Dependencies**: Email service setup (US-050)
- **Notes**: Integrate with existing authentication system

Story Splitting Techniques

Vertical Slicing

Split by user workflow steps:

  • Story 1: User can view product list
  • Story 2: User can filter products
  • Story 3: User can sort products

Horizontal Slicing

Split by technical layers:

  • Story 1: Backend API for user data
  • Story 2: Frontend user interface
  • Story 3: Data validation and error handling

Quality Checklist

INVEST Criteria

  • Independent: Can be developed separately
  • Negotiable: Details can be discussed
  • Valuable: Provides business value
  • Estimable: Can be sized appropriately
  • Small: Fits within a sprint
  • Testable: Has clear acceptance criteria

Common Anti-Patterns to Avoid

  • Technical jargon in user-facing stories
  • Vague acceptance criteria ("system should work well")
  • Stories too large for a single sprint
  • Missing business value justification
  • Acceptance criteria that aren't testable

Epic and Theme Organization

Epic Structure

### Epic: User Account Management

**Goal**: Enable users to manage their account information and preferences

**User Stories**:
- US-001: User Registration
- US-002: User Login
- US-003: Password Reset
- US-004: Profile Management
- US-005: Account Deactivation

**Success Metrics**:
- 90% successful registration completion rate
- <2 second login response time
- <5% password reset requests

Stakeholder Communication

Story Presentation Format

  • Lead with business value
  • Use plain language, avoid technical terms
  • Include visual mockups when helpful
  • Provide effort estimates in business terms
  • Highlight dependencies and risks clearly

Review and Refinement

  • Regular backlog grooming sessions
  • Story point re-estimation based on new information
  • Continuous acceptance criteria refinement
  • Stakeholder feedback incorporation

FAQ

Common questions

Discussion

Questions & comments ยท 0

Sign In Sign in to leave a comment.