uat-story-writer

Generate user story documents with Gherkin acceptance criteria for UAT scenarios.

42|7|Updated Apr 17, 2026
One-click install
npx skills add https://github.com/addxai/enterprise-harness-engineering --skill uat-story-writer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: uat-story-writer
Source: https://github.com/addxai/enterprise-harness-engineering/tree/main/skills/uat-story-writer
Command: npx skills add https://github.com/addxai/enterprise-harness-engineering --skill uat-story-writer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Teams often miss critical UAT test scenarios because they are written from a technical implementation perspective instead of real user usage contexts, leading to untested edge cases that cause post-release user experience issues and increased review burden.

Core Features & Use Cases

  • Guided Requirement Confirmation: Conducts short, multiple-choice interviews to gather key constraints like test environment capabilities and usage topology without overwhelming users.
  • User-Centric Scenario Brainstorming: Generates test scenarios based on real user daily usage journeys (e.g., checking order status on mobile data while away from home) instead of technical conditions.
  • Standardized Output: Produces user story files following the story-craftsman template with executable Gherkin Given/When/Then acceptance criteria, saved directly to the project's cases directory.
  • Use Case: For a new live view feature, this skill identifies missing scenarios like network switching during viewing, low-signal area access, and permission revocation for shared views, then generates ready-to-use user story documents for the QA team.

Quick Start

Use the uat-story-writer skill to identify all missing UAT scenarios for the new order tracking feature and generate the corresponding user story files saved to the cases directory.

Frequently Asked Questions about uat-story-writer

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

FAQPage Schema
How do I write user acceptance test scenarios that cover real user behavior instead of technical conditions?

To generate user acceptance test scenarios from real behavior, brainstorm test cases based on daily user journeys like checking order status on mobile data. This approach eliminates coverage gaps caused by technical-perspective test case writing.

What are Gherkin acceptance criteria and when do I need them for UAT testing?

Gherkin acceptance criteria use Given/When/Then syntax to define executable test scenarios for UAT testing. You need them to standardize user-centric acceptance test cases aligned with actual end-user behavior and daily usage journeys.

Can I generate user story files with executable Gherkin Given/When/Then acceptance criteria automatically?

Yes, you can generate standardized user story files with executable Gherkin Given/When/Then acceptance criteria automatically. The output follows the story-craftsman template and is saved directly to the project's cases directory for immediate use.

Why does my UAT test coverage miss edge cases like network switching or low-signal area access?

UAT test coverage misses edge cases like network switching or low-signal access because scenarios are written from a technical implementation perspective. Shifting to user-centric scenario brainstorming based on real daily usage journeys uncovers these missing test scenarios.

What do I need to prepare before generating UAT test scenarios for a new feature?

Before generating UAT test scenarios, you need to provide key constraints like test environment capabilities and usage topology. A short, multiple-choice interview helps gather these requirements without overwhelming the user during the setup process.