User Story

Generate user stories and Gherkin acceptance criteria for product management.

1|Updated Mar 11, 2026
One-click install
npx skills add https://github.com/zhengxuyu/default-talents --skill user-story-zhengxuyu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: User Story
Source: https://github.com/zhengxuyu/default-talents/tree/main/product-manager-skills/skills/user-story
Command: npx skills add https://github.com/zhengxuyu/default-talents --skill user-story-zhengxuyu

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps product managers and teams create clear, concise, and actionable user stories that bridge the gap between user needs and development tasks, ensuring shared understanding and testable outcomes.

Core Features & Use Cases

  • User Story Creation: Formulates stories using the "As a / I want / so that" format.
  • Acceptance Criteria: Defines testable scenarios using Gherkin's "Given / When / Then" structure.
  • Use Case: A product manager needs to define a new feature for user login. They use this Skill to write a user story like "As a new user, I want to log in with Google, so that I can access the app quickly without creating a new password," along with specific acceptance criteria for successful login.

Quick Start

Use the User Story skill to write a story for a new user wanting to sign up with their email.

Frequently Asked Questions about User Story

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

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

To write user stories with Gherkin acceptance criteria, formulate the story using the "As a / I want / so that" format, then define testable scenarios using the Given / When / Then structure to ensure shared understanding and actionable development work.

What is the best way to translate user needs into testable development tasks?

Translating user needs into testable development tasks requires structuring requirements as user stories with specific acceptance criteria, bridging communication between product, engineering, and QA teams through actionable and testable success outcomes.

How does the Gherkin Given When Then format work for agile acceptance criteria?

The Gherkin Given When Then format works for agile acceptance criteria by defining preconditions (Given), actions (When), and expected outcomes (Then), creating clear, testable scenarios that validate user story completion during backlog grooming and sprint planning.

Can I use Mike Cohn's user story format for sprint planning and backlog grooming?

Yes, you can use Mike Cohn's user story format for sprint planning and backlog grooming to translate user needs into concise, actionable development tasks that facilitate communication and ensure testable success criteria across product and engineering teams.

When do I need to define acceptance criteria for a user story?

You need to define acceptance criteria for a user story when translating product requirements into actionable development work, ensuring the engineering and QA teams have testable scenarios to validate successful feature implementation and shared understanding.