story-readiness

Validate story files for implementation readiness against GDD, ADR, and acceptance criteria.

Updated Apr 9, 2026
One-click install
npx skills add https://github.com/CarlosQ96/robot-crawler --skill story-readiness
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: story-readiness
Source: https://github.com/CarlosQ96/robot-crawler/tree/main/.agents/skills/story-readiness
Command: npx skills add https://github.com/CarlosQ96/robot-crawler --skill story-readiness

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Teams often start implementing stories that lack complete design references, clear acceptance criteria, or proper asset links, leading to mid‑sprint delays and rework. This Skill determines whether a story is fully ready for development.

Core Features & Use Cases

  • Comprehensive checklist: Verifies GDD references, ADR status, acceptance criteria, asset existence, estimates, and dependencies.
  • Flexible scope: Works on a single story file, all stories in the current sprint, or every story in the production epics folder.
  • Actionable verdicts: Returns READY, NEEDS WORK, or BLOCKED along with specific gaps, enabling quick triage before sprint planning.

Quick Start

Run the story-readiness skill on a story file to receive an immediate implementation‑ready verdict.

Frequently Asked Questions about story-readiness

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

FAQPage Schema
How do I validate story readiness before starting sprint implementation?

You can validate story readiness across a single file, all stories in the current sprint, or every story in the production epics folder. The skill checks GDD references, ADR status, acceptance criteria, asset existence, estimates, and dependencies to return a verdict.

How do I check if a user story has all required acceptance criteria and ADR status?

To check acceptance criteria and ADR status, apply the readiness checklist to the story file. The skill verifies these elements alongside GDD references and asset existence, then returns specific gaps to enable quick triage before sprint planning.

What is story readiness validation and when do I need it for sprint planning?

Story readiness validation is the process of verifying that a story file has complete design references, clear acceptance criteria, and proper asset links before implementation. You need it during development planning to prevent mid-sprint delays and rework.

Can I check all stories in a sprint for implementation readiness at once?

Yes, you can check all stories in a sprint at once by applying the skill to the sprint scope. It evaluates every story file in that range and returns individual READY, NEEDS WORK, or BLOCKED verdicts along with specific gaps for quick triage.

Why does my story implementation get blocked mid-sprint due to missing GDD references?

Story implementation gets blocked mid-sprint when files lack complete GDD references, clear acceptance criteria, or proper asset links. Validating story readiness before development planning identifies these specific gaps early to prevent delays and rework.

Does story readiness validation work on individual story paths or entire epic folders?

Story readiness validation works flexibly on individual story paths, all stories in the current sprint, or every story in the production epics folder. It processes each scope to return comprehensive verdicts and specific gaps for quick triage.