story-quality

Review user stories for scope, clarity, dependencies, and acceptance criteria.

232|38|Updated Jan 18, 2026
One-click install
npx skills add https://github.com/rohunj/claude-build-workflow --skill story-quality
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: story-quality
Source: https://github.com/rohunj/claude-build-workflow/tree/main/skills/story-quality
Command: npx skills add https://github.com/rohunj/claude-build-workflow --skill story-quality

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Review teams regularly face poorly scoped user stories, missing acceptance criteria, and unclear sequencing, which can derail autonomous execution and PRD-to-implementation flows.

Core Features & Use Cases

  • Provides a structured quality review of each user story against size, clarity, dependencies, and acceptance criteria.
  • Generates actionable recommendations to refine stories before converting to PRD artifacts.
  • Guides ordering to ensure prerequisites come before dependent stories and supports consistent iteration planning.

Quick Start

Prompt Claude to review the PRD and return a structured quality report with concrete improvements.

Frequently Asked Questions about story-quality

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

FAQPage Schema
How do I review user stories for autonomous build readiness?

To review user stories for autonomous execution, you need to verify clear scope, dependency checks, and validation guardrails. A structured quality review evaluates each story against clarity and testability to ensure it is properly scoped before implementation.

What makes a good user story for agile development loops?

A good agile user story requires clear formatting, precise scope definitions, and verifiable acceptance criteria. It must be well-scoped and testable, allowing autonomous execution loops to process the requirements without ambiguity or missing sequencing dependencies.

How do I add acceptance criteria to PRD-derived stories?

Adding acceptance criteria to PRD-derived stories involves applying validation guardrails to define testable conditions. A structured review identifies missing criteria and generates actionable recommendations to refine each story before it is converted into a PRD artifact.

Can I use requirement analysis to sequence dependent user stories?

Yes, requirement analysis can sequence dependent user stories by checking dependencies and guiding story ordering. This ensures prerequisites are completed before dependent stories, supporting consistent iteration planning and preventing derailment during execution.

When do I need a user story quality review?

You need a user story quality review when preparing PRD-derived stories for autonomous execution across product, engineering, and design workflows. It is essential when stories lack clear scope definitions or verifiable acceptance criteria that could derail implementation.

What is the best way to refine poorly scoped user stories?

The best way to refine poorly scoped user stories is to perform a structured review against size, clarity, and dependencies. This generates actionable recommendations and concrete improvements to ensure stories are well-scoped before autonomous execution.