Story Readiness
Checks whether a story is ready to implement: clear acceptance criteria, no open...
Install
npx skills add Donchitos/Claude-Code-Game-Studios --skill story-readiness -g -a claude-code -y- Repository
- Donchitos/Claude-Code-Game-Studios32.1k
- Category
- Engineering
- Updated
- 17d ago
- License
- MIT
- Context cost
- Mediumabout 3,000 tokens
- Runs scripts
- No, instructions only
What it does
Checks whether a story is ready to implement: clear acceptance criteria, no open questions, valid ADR and dependencies. Use when the user asks if a story, or the sprint's stories, are ready to start or build.
!bash "${CLAUDE_SKILL_DIR}/../../hooks/yaml-helper.sh" resolve_config --keys review_mode,review_gate,automation,workflow,qa.level,gate_level,story_granularity,system_overrides
Resolved above, use as-is; --review overrides review_mode. No block →
defaults in .claude/docs/config-resolution.md.
Ask with the question tool. Without one, list the options numbered and end your turn to wait. A skipped or dismissed question is not an answer: ask again in plain text.
Story Readiness
Checks that a story file holds everything a developer needs before writing code: no design questions mid-build, no guessing, no vague acceptance criteria.
Read-only. It never writes or edits a file. It reports, and offers to draft fixes in the conversation.
Verdicts, one per story. The first that matches wins, in this order:
- BLOCKED: a finding the reader can clear. A referenced ADR is missing,
Proposed,DeprecatedorSuperseded; a dependency story is missing orDraft; or a criterion holds an UNRESOLVED design question with no owner. - NEEDS WORK: a blocking checklist item fails. The story can be fixed now.
- NOT ASSESSED: the story could not be evaluated. The file is unreadable,
a referenced ADR has no readable
## Status, or the design document it names cannot be found. Name what could not be read. It is never READY: a story nobody could check has not been shown ready. It ranks below the two failures, because a known blocker is more useful than an unknown. - READY: every item passes, is N/A with a reason, or is advisory. Advisory gaps are still listed.
Asks follow .claude/docs/automation-modes.md (collaborative always asks, guided
asks on major choices, autonomous logs and goes on; automation_always_ask
categories always ask).
