skills.rest
claretagrapelike32
claretagrapelike32COMMUNITY
Explore all skills by this author →
GitHub

story-readiness

Validates game development story files against GDD, ADR, and acceptance criteria checklists.

Updated Aug 2, 2026
Search Tags:#game development#adr#acceptance criteria#sprint planning#story validation#readiness check#gdd
One-click install
npx skills add https://github.com/claretagrapelike32/codex-ai-game-studio --skill story-readiness-claretagrapelike32
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: story-readiness
Source: https://github.com/claretagrapelike32/codex-ai-game-studio/tree/main/plugins/ai-game-studio/skills/story-readiness
Command: npx skills add https://github.com/claretagrapelike32/codex-ai-game-studio --skill story-readiness-claretagrapelike32

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams often assign stories that are missing design references, testable acceptance criteria, or valid dependencies, causing mid-sprint interruptions and rework. This Skill inspects story files before assignment and reports exactly what is missing so developers only start work on implementation-ready stories. ## Core Features & Use Cases - Readiness Checklist Validation: Evaluates each story against design completeness, architecture completeness, scope clarity, open questions, asset references, and definition-of-done criteria. - Verdict Reporting: Assigns READY, NEEDS WORK, or BLOCKED verdicts with specific gap descriptions and fix instructions per story. - Multi-Scope Review: Validates a single story file, all stories in the current sprint plan, or every story under production/epics/, with sprint escalation warnings for Must Have stories. - Use Case: Before sprint planning, run the skill with the sprint scope to confirm every Must Have story references an accepted ADR, has testable acceptance criteria, and lists no DRAFT dependencies. ## Quick Start Ask the AI to run the story-readiness skill on a specific story file or on the current sprint to get a readiness verdict with gaps.

Frequently Asked Questions about story-readiness

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

FAQPage Schema
How do I check if a story is ready to implement?▼

Run the skill with the story file path as the argument. It evaluates design completeness, architecture references, scope clarity, and definition of done, then returns a READY, NEEDS WORK, or BLOCKED verdict with specific gaps and fixes.

How do I validate all stories in a sprint at once?▼

Pass the sprint scope argument to the skill. It reads the most recent sprint plan from production/sprints/, extracts every referenced story path, validates each one, and warns if any Must Have stories are not implementation-ready.

What makes a story BLOCKED instead of NEEDS WORK?▼

A story is BLOCKED when a dependency story is missing or in DRAFT status, a referenced ADR is still Proposed or missing, or a critical design question flagged UNRESOLVED has no owner. Other checklist failures produce NEEDS WORK.

Does the story readiness check edit story files?▼

No, the skill is read-only and never modifies story files. It reports findings and offers to draft missing sections in conversation, leaving all writing to the user or the create-stories skill.

What happens when a story references an ADR that is still Proposed?▼

The story is marked BLOCKED because a Proposed ADR may change before acceptance, making the story's implementation guidance unreliable. The fix is to wait for the ADR to reach Accepted status before implementing.

Related Skills

Explore More Product & Management Skills→
DonchitosDonchitos
24.7k

create-stories

Decomposes a game development epic into implementable story files with acceptance criteria and test specs.

Community
Advanced
DonchitosDonchitos
24.7k

story-done

Verifies story acceptance criteria, checks design deviations, and closes completed sprint stories.

Community
Advanced
nevesbnevesb

story-readiness

Validate story files for implementation readiness and produce READY, NEEDS WORK, or BLOCKED verdicts.

Community
Advanced
nevesbnevesb

quick-design

Draft lightweight design specs for small gameplay changes with acceptance criteria.

Community
Intermediate