user-story

Convert user needs into user stories with Gherkin acceptance criteria.

1|Updated Mar 30, 2026
One-click install
npx skills add https://github.com/tabooes/pm_skills --skill user-story-tabooes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: user-story
Source: https://github.com/tabooes/pm_skills/tree/main/skills/user-story
Command: npx skills add https://github.com/tabooes/pm_skills --skill user-story-tabooes

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill helps product teams convert vague user needs into clear, testable user stories using the Mike Cohn format and Gherkin-style acceptance criteria, ensuring shared understanding and faster delivery.

Core Features & Use Cases

  • Write Use Case: As a [role], I want to [action], so that [outcome].
  • Write Acceptance Criteria: Structure with Scenario, Given/and Given/When/Then ensuring testability.
  • Optional Helper Script: Use the included script to generate a ready-to-edit story template.

Quick Start

Write a single user story using the included template to convert a user need into testable acceptance criteria.

Frequently Asked Questions about user-story

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

FAQPage Schema
How do I write testable user stories with Gherkin acceptance criteria?

To write testable user stories, structure acceptance criteria using Gherkin syntax with Scenario, Given, When, and Then statements to ensure shared understanding and faster delivery across the product team.

What is the best way to format user stories for backlog refinement?

The best way to format user stories for backlog refinement is using the Mike Cohn format: As a [role], I want to [action], so that [outcome], paired with structured Gherkin acceptance criteria for measurable testability.

How do I convert vague product needs into actionable sprint planning items?

Converting vague product needs into actionable sprint planning items requires applying the Mike Cohn format to define the role, action, and outcome, then adding Gherkin-style acceptance criteria to validate the use case.

Does this user story template support splitting large stories?

Yes, the user story template supports story splitting during problem validation by breaking down fuzzy needs into concise Use Case sections with measurable acceptance criteria for each distinct scenario.

Can I generate a ready-to-edit user story template for sprint planning?

Yes, you can generate a ready-to-edit user story template by running the included helper script, which produces a structured outline for immediate use in backlog refinement and sprint planning sessions.