test-stories

Convert Markdown user stories into automated browser acceptance tests.

1|Updated Mar 7, 2026
One-click install
npx skills add https://github.com/ssv445/claude-skills --skill test-stories
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: test-stories
Source: https://github.com/ssv445/claude-skills/tree/main/test-stories
Command: npx skills add https://github.com/ssv445/claude-skills --skill test-stories

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

AI-driven QA for validating user stories by transforming Markdown story definitions into automated browser tests, reducing manual verification time.

Core Features & Use Cases

  • Reads user-story markdown files and executes acceptance criteria via subagents.
  • Automates browser tests across stories in docs/user-stories/ and specific stories via filters (e.g., /test-stories FEED-05).
  • Orchestrates testing flow with agent-led steps and reporting to a consolidated result.

Quick Start

Invoke /test-stories to run all stories, or /test-stories FEED-05 to run a specific story.

Frequently Asked Questions about test-stories

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

FAQPage Schema
How do I automate user story testing from Markdown files?

Automating user story testing from Markdown files involves converting story definitions into automated acceptance tests. This Skill reads Markdown criteria, uses subagents to interpret them, and executes browser automation to validate the expected software behavior.

Can I run targeted browser automation tests for a specific story instead of the full suite?

Yes, you can run targeted browser automation tests for a specific story. By invoking the command with a specific story filter, such as providing a story identifier, the testing flow bypasses the full suite and validates only that targeted story.

What is AI-driven story testing and how does it handle acceptance criteria?

AI-driven story testing is the process of using subagents to interpret Markdown acceptance criteria and execute browser automation. It orchestrates an agent-led testing flow that performs deterministic checks and captures snapshots to validate user stories.

Does Playwright work with AI subagents for automated QA workflows?

Playwright works with AI subagents for automated QA workflows by executing the browser automation steps directed by the subagents. The subagents interpret the story criteria and orchestrate Playwright to perform deterministic checks and take snapshots.

Do I need to write test scripts manually for Markdown user stories?

No, you do not need to write test scripts manually for Markdown user stories. The automated QA workflow directly reads the Markdown definitions and uses AI subagents to interpret the acceptance criteria and execute the browser tests automatically.