prod-user-story-refiner

Community

Make user stories implementable and testable

AuthorFernanSuoza
Version1.0.0
Installs0

System Documentation

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.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: prod-user-story-refiner
Download link: https://github.com/FernanSuoza/AIDD-project-bootstrap/archive/main.zip#prod-user-story-refiner

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.