story-ready-check

Analyze user stories against agile Definition of Ready criteria.

Updated Dec 16, 2025
One-click install
npx skills add https://github.com/csmarkus/startpage --skill story-ready-check
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: story-ready-check
Source: https://github.com/csmarkus/startpage/tree/main
Command: npx skills add https://github.com/csmarkus/startpage --skill story-ready-check

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Analyzes user stories to determine if they meet agile Definition of Ready criteria, helping teams decide when a story is ready for pointing or sprint planning and reducing rework.

Core Features & Use Cases

  • DoR adherence checks: validates that each story follows a clear format (As a..., I want..., So that...), includes explicit acceptance criteria, is independently deliverable, is appropriately scoped for a single sprint, and is testable.
  • Readiness scorecard: generates a structured scorecard with gaps and actionable rewrites to improve story quality.
  • Multi-story analysis: handles one or more stories from uploaded documents and produces per-story assessments plus a rollup for backlog grooming.

Quick Start

Upload a story document or paste the story text to begin analysis.

Frequently Asked Questions about story-ready-check

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

FAQPage Schema
How do I check if my user stories meet Definition of Ready criteria?

To check Definition of Ready criteria, upload a markdown or document file containing your user stories. The analysis assesses user story format, acceptance criteria, independence, sizing, and testability, returning a per-story readiness scorecard with actionable rewrites.

What is analyzed during backlog grooming for story readiness?

Backlog grooming for story readiness analyzes whether each story follows the As a..., I want..., So that... format, includes explicit acceptance criteria, is independently deliverable, is sprint-appropriately scoped, and is testable, generating a rollup assessment for the entire backlog.

How do I analyze multiple user stories for sprint planning readiness?

You can analyze multiple user stories for sprint planning by uploading a document containing one or more stories. The assessment produces per-story readiness checks alongside a concise scorecard detailing gaps and concrete rewrites to improve story quality.

Can I use markdown files to assess user story acceptance criteria and testability?

Yes, you can use markdown files to assess user story acceptance criteria and testability. The analysis accepts uploaded markdown or document files, validates the stories against agile readiness rules, and provides detailed notes on any gaps found.

What is the best way to fix ambiguous user stories before pointing?

The best way to fix ambiguous user stories before pointing is to analyze them for unambiguous language and missing acceptance criteria. The assessment provides concrete, actionable rewrites for any gaps to ensure stories are independently deliverable and testable.

Why does a user story fail readiness checks for sprint planning?

A user story fails readiness checks when it lacks a clear format, explicit acceptance criteria, independent deliverability, appropriate sprint sizing, or testability. The analysis identifies these specific gaps and provides actionable rewrites to achieve readiness.