user-story-builder

Convert raw user problems into INVEST-compliant user stories with acceptance criteria.

Updated Mar 12, 2019
One-click install
npx skills add https://github.com/gustavofsantos/dot-files --skill user-story-builder-gustavofsantos
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: user-story-builder
Source: https://github.com/gustavofsantos/dot-files/tree/main/skills/user-story-builder
Command: npx skills add https://github.com/gustavofsantos/dot-files --skill user-story-builder-gustavofsantos

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Transform raw user problems or ideas into well-defined, INVEST-compliant user stories with clear acceptance criteria, ensuring alignment between the facilitator and the user before development begins.

Core Features & Use Cases

  • Phase-driven approach that clarifies who, what, why, and when
  • Drafts a concise user story template with acceptance criteria
  • Iterative alignment and refinement until the user confirms
  • Outputs a final story block with title, narrative, and scope notes

Quick Start

Provide a raw problem or idea and the skill will guide you through clarifying questions to deliver a complete, INVEST-compliant user story.

Frequently Asked Questions about user-story-builder

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

FAQPage Schema
How do I convert a raw product idea into a structured user story?

To convert a raw product idea into a user story, provide the initial concept to trigger a phase-driven clarification process. This guides you through defining who, what, and why, drafting a narrative, and iterating until you confirm alignment.

How do I write acceptance criteria for ambiguous requirements?

Writing acceptance criteria for ambiguous requirements involves a phase-driven clarification process that defines who, what, and why. The system drafts a template and refines it iteratively with you until the acceptance criteria are clear and aligned.

What is the INVEST criteria for product management user stories?

INVEST criteria for product management user stories ensures requirements are Independent, Negotiable, Valuable, Estimable, Small, and Testable. This skill enforces INVEST compliance while drafting your narrative to guarantee a well-defined, ready-to-implement story.

Can I use this approach to align with stakeholders before development begins?

You can align with stakeholders before development begins through iterative refinement. The skill facilitates problem understanding and drafts the story, prompting confirmation from all parties to ensure alignment before outputting the final story block.

What is the best way to structure a user story template?

The best way to structure a user story template is using a phase-driven approach that clarifies the who, what, and why. This yields a final story block containing a title, narrative, acceptance criteria, and scope notes.