prod-user-story-refiner

Refine user stories into INVEST-compliant items with Given-When-Then criteria.

Updated Mar 22, 2026
One-click install
npx skills add https://github.com/FernanSuoza/AIDD-project-bootstrap --skill prod-user-story-refiner
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: prod-user-story-refiner
Source: https://github.com/FernanSuoza/AIDD-project-bootstrap/tree/main/templates/skills/prod-user-story-refiner
Command: npx skills add https://github.com/FernanSuoza/AIDD-project-bootstrap --skill prod-user-story-refiner

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Backlog items are often vague, oversized, mixed-owner, or lacking measurable acceptance criteria, which makes them hard to estimate, implement, and verify. This Skill turns those weak stories into small, testable, and actionable work items so teams can deliver predictably and reduce rework.

Core Features & Use Cases

  • INVEST-based refinement: Diagnose stories using INVEST checks and reshape them to be Independent, Negotiable, Valuable, Estimable, Small, and Testable.
  • Acceptance criteria tightening: Convert vague requirements into outcome-focused, Given-When-Then criteria that are verifiable by tests or manual checks.
  • Splitting & linking: Split oversized or mixed-owner stories into smaller, linked stories and document blockers, dependencies, and follow-ups.
  • Use case: During backlog grooming, convert a vague "Improve dashboard" item into focused, estimable stories with measurable success criteria and test strategies.

Quick Start

Refine this story into an INVEST-compliant, implementable user story with clear Given-When-Then acceptance criteria and list any blockers and follow-up tasks.

Frequently Asked Questions about prod-user-story-refiner

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

FAQPage Schema
What is the best way to split oversized or mixed-owner user stories for sprint planning?

Tightening acceptance criteria for user stories means converting vague requirements into outcome-focused Given-When-Then statements. These verifiable criteria ensure each story is testable through automated tests or manual checks during sprint planning.

What is the best way to split oversized or mixed-owner user stories for sprint planning?

Splitting oversized user stories for sprint planning breaks large or mixed-owner items into smaller, linked stories. This refinement action produces focused work items that are easier to estimate, implement, and verify while documenting dependencies.

Can I document blockers and dependencies when refining user stories?

Writing Given-When-Then acceptance criteria for agile requirements transforms vague needs into verifiable outcomes. The process specifies a starting state, an action, and an expected result to ensure the user story is fully testable.

Can I document blockers and dependencies when refining user stories?

Documenting blockers and dependencies during user story refinement records explicit obstacles and links to project guidelines. This captures follow-up tasks and evidence links needed to verify story completion and manage team workflow.

Why does my agile backlog have unestimable and untestable user stories?

Agile backlogs contain unestimable and untestable user stories when items are vague, oversized, or lack measurable acceptance criteria. Refining these stories into small, outcome-focused items resolves this issue and reduces implementation rework.