story-quality

Assesses user stories for quality, sizing, sequencing and acceptance criteria before PRD conversion.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/mirandagabrieldev/claude-build-template --skill story-quality-mirandagabrieldev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: story-quality
Source: https://github.com/mirandagabrieldev/claude-build-template/tree/main/skills/story-quality
Command: npx skills add https://github.com/mirandagabrieldev/claude-build-template --skill story-quality-mirandagabrieldev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Review and improve the quality of user stories before PRD conversion, ensuring clarity, proper sizing, sequencing, and robust acceptance criteria to reduce rework and misalignment.

Core Features & Use Cases

  • Evaluate descriptions for clarity and focus on a single capability
  • Check story size to fit a single autonomous iteration
  • Verify dependency order and sequencing across stories
  • Validate acceptance criteria with verifiable checks (e.g., typecheck) and UI browser verification where applicable

Quick Start

Review the provided PRD and generate a structured story-quality report with actionable fixes.

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 backlog readiness and sprint planning?

Assess user stories by evaluating descriptions for single-capability focus, verifying iteration sizing, checking dependency sequencing, and validating acceptance criteria before backlog grooming and sprint planning to ensure autonomous execution readiness.

How do I validate acceptance criteria for user stories with UI browser verification?

Validate acceptance criteria by enforcing verifiable checks like typecheck and explicit UI browser verification for interface stories. Ensure criteria are robust and testable before converting to prd.json to reduce rework and misalignment during execution.

What is the best way to size user stories for autonomous execution?

Size user stories for autonomous execution by verifying each story fits a single autonomous iteration and focuses on a single capability. This prevents oversized tasks from blocking autonomous development flow and reduces execution rework.

Why does story sequencing matter during PRD conversion?

Story sequencing matters during PRD conversion because verifying dependency order across stories ensures proper execution flow. Correctly ordered stories prevent blockers during autonomous execution, reducing misalignment and rework when converting to prd.json.

Does story-quality review work for backlog grooming across multiple sprints?

Story-quality review works for backlog grooming by applying assessment reports to structure story fixes across sprints. It enforces correct prioritization and validates acceptance criteria, ensuring dependencies and sizing are managed for continuous autonomous execution.