story-readiness

Validate story files for implementation readiness and produce per-story verdicts.

Updated Apr 10, 2026
One-click install
npx skills add https://github.com/emcconnell/nova-scout --skill story-readiness-emcconnell
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: story-readiness
Source: https://github.com/emcconnell/nova-scout/tree/main/.claude/skills/story-readiness
Command: npx skills add https://github.com/emcconnell/nova-scout --skill story-readiness-emcconnell

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill validates whether a development story file is ready for implementation by checking that design requirements, acceptance criteria, architecture references, asset links, estimates, dependencies, and open questions are complete and unambiguous so engineers can start without mid-sprint design interruptions.

Core Features & Use Cases

  • Comprehensive readiness checks: Verifies GDD references, testable acceptance criteria, ADR status, TR-ID validity, manifest version alignment, engine notes, and control manifest considerations.
  • Scope and dependency analysis: Confirms estimates, in-scope/out-of-scope boundaries, listed dependencies, and whether dependency stories exist or are in DRAFT.
  • Asset verification and verdicts: Globs referenced assets for existence and emits a per-story verdict (READY / NEEDS WORK / BLOCKED) with explicit gap descriptions and blockers; supports single-file, sprint, or all-epics scopes and sprint escalation alerts.
  • Collaboration and gating: Produces outputs formatted for QA review, honors review-mode settings, and can spawn director gates for full review when configured.

Quick Start

Validate the story at production/epics/combat/story-001-basic-attack.md and report READY, NEEDS WORK, or BLOCKED with specific gaps and fixes.

Frequently Asked Questions about story-readiness

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

FAQPage Schema
How do I validate user stories for sprint readiness before implementation?

To validate user stories for sprint readiness, check design references, testable acceptance criteria, ADR status, TR-IDs, asset existence, and estimates to produce per-story verdicts like READY or BLOCKED.

What is story readiness and what problem does it solve for developers?

Story readiness is the process of validating development story files for completeness, ensuring design requirements, acceptance criteria, and dependencies are unambiguous so engineers can start without mid-sprint design interruptions.

How do I check acceptance criteria and ADR references across an entire sprint?

To check acceptance criteria and ADR references across a sprint, apply readiness validation to all story files in the scope, generating prioritized gap lists for developers, QA, and producers during sprint planning.

Do I need write access to the repository to review story files?

You do not need write access to review story files; the process requires read-only access to repository text files plus glob and grep capabilities to verify assets and manifest alignment.

How do I identify blocked stories with missing dependencies or open questions?

Identify blocked stories with missing dependencies by validating in-scope boundaries, listed dependencies, and open questions, emitting a BLOCKED verdict with explicit gap descriptions and blockers for sprint escalation.