user-story-writer

Generate user stories with INVEST criteria and BDD acceptance criteria.

Updated Mar 14, 2026
One-click install
npx skills add https://github.com/MrAlexisCord/chatbot-prototype --skill user-story-writer-mralexiscord
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: user-story-writer
Source: https://github.com/MrAlexisCord/chatbot-prototype/tree/main/.agents/skills/user-story-writer
Command: npx skills add https://github.com/MrAlexisCord/chatbot-prototype --skill user-story-writer-mralexiscord

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you write clear, actionable, and high-quality user stories that adhere to the INVEST criteria and include well-defined BDD acceptance criteria, reducing ambiguity and improving development efficiency.

Core Features & Use Cases

  • User Story Writing: Crafts user stories in standard, context-first, or outcome-first formats.
  • INVEST Criteria Check: Guides users through a checklist to ensure stories are Independent, Negotiable, Valuable, Estimable, Small, and Testable.
  • BDD Acceptance Criteria: Generates acceptance criteria in Given/When/Then format, covering happy paths, edge cases, and error scenarios.
  • Story Splitting: Provides techniques like SPIDR and workflow splits to break down large epics into manageable stories.
  • Use Case: A Product Owner needs to define a new feature. They can use this Skill to write a user story for "As a registered user, I want to reset my password, so that I can regain access to my account if I forget it," complete with specific acceptance criteria like "Given I am on the login page and enter my registered email, When I click 'Forgot Password', Then I receive an email with a password reset link."

Quick Start

Use the user-story-writer skill to write a user story for a login feature with BDD acceptance criteria.

Frequently Asked Questions about user-story-writer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write user stories with BDD acceptance criteria in Given/When/Then format?

Splitting epics into user stories uses techniques like SPIDR and workflow splits to break down large items into manageable, independent stories that adhere to INVEST criteria and remain estimable and testable.

What is the INVEST criteria checklist for agile user stories?

To add edge cases to user stories, generate BDD acceptance criteria in Given/When/Then format that explicitly covers error scenarios and boundary conditions alongside the happy path to ensure comprehensive testability.

How do I split large epics into smaller manageable user stories?

Splitting epics into user stories uses techniques like SPIDR and workflow splits to break down large items into manageable, independent stories that adhere to INVEST criteria and remain estimable and testable.

Can I use standard, context-first, and outcome-first formats for user story writing?

User stories can be crafted in standard, context-first, or outcome-first formats, allowing you to structure the narrative based on the specific feature requirements and desired development outcomes.

How do I add edge cases to BDD acceptance criteria for user stories?

To add edge cases to user stories, generate BDD acceptance criteria in Given/When/Then format that explicitly covers error scenarios and boundary conditions alongside the happy path to ensure comprehensive testability.