story-readiness SKILL.md skillA

story-readiness from striderza/opencodegamestudios is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add striderza/opencodegamestudios/story-readiness@git:20260622.695134d

Pins git:20260622.695134d in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
striderza/opencodegamestudios
Path
.agents/skills/story-readiness/SKILL.md
Versions recorded
2
Latest version
git:20260622.695134d, committed Jun 22, 2026
First version recorded
Jun 21, 2026
Size
15,381 bytes
Repository stars
99
License
MIT

Validate that a story file is implementation-ready. Checks for embedded GDD requirements, ADR references, engine notes, clear acceptance criteria, and no open design questions. Produces READY / NEEDS WORK / BLOCKED verdict with specific gaps. Use when user says 'is this story ready', 'can I start on this story', 'is story X ready to implement'.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Story Readiness

This skill validates that a story file contains everything a developer needs
to begin implementation — no mid-sprint design interruptions, no guessing,
no ambiguous acceptance criteria. Run it before assigning a story.

**This skill is read-only.** It never edits story files. It reports findings
and asks whether the user wants help filling gaps.

**Output:** Verdict per story (READY / NEEDS WORK / BLOCKED) with a specific
gap list for each non-ready story.

---

## Phase 0: Resolve Review Mode

Resolve the review mode once at startup (store for all gate spawns this run):

1. If skill was called with `--review [full|lean|solo]` → use that value
2. Else read `production/review-mode.txt` → use that value
3. Else → default to `lean`

See `docs/framework/director-gates.md` for the full check pattern and mode definitions.

---

## 1. Parse Arguments

**Scope:** `$ARGUMENTS[0]` (blank = ask user via question)

- **Specific path** (e.g., `/story-readiness production/epics/combat/story-001-basic-attack.md`):
  validate that single story file.
- **`sprint`**: read the current sprint plan from `production/sprints/` (most
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add striderza/opencodegamestudios/story-readiness@sha256:0ac261a75feb7aa6

The line at the top of this page pins the label git:20260622.695134d, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_fuhrvpmqv4graecf.svg)](https://markdownregistry.com/a/art_fuhrvpmqv4graecf)

0 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 2 versions of this file, between Jun 21, 2026 and Jun 22, 2026, about one every day.

versioncommittedcommitsizeaudit
git:20260622.695134d latest2026-06-22 695134d 15,381 BA view · diff
git:20260621.096f0402026-06-21 096f040 15,381 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (15381 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

striderza/opencodegamestudios · 99 stars · license MIT · pushed 2026-10-06 · branch master

API

GET https://markdownregistry.com/api/v1/artifacts/art_fuhrvpmqv4graecf
GET https://markdownregistry.com/api/v1/resolve?ref=striderza/opencodegamestudios/story-readiness
GET https://markdownregistry.com/api/v1/blob/0ac261a75feb7aa610ea9a145076b2b0d9ca3493c7d81557bf09c48afb5d6446

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from striderza/opencodegamestudios

architecture-review SKILL.md skill
striderza/opencodegamestudios · .agents/modules/architecture/skills/architecture-review/SKILL.md · Validates completeness and consistency of the project architecture against all GDDs. Builds a traceability matrix…
git:20260622.695134d · audit A · 99 stars
create-control-manifest SKILL.md skill
striderza/opencodegamestudios · .agents/modules/architecture/skills/create-control-manifest/SKILL.md · After architecture is complete, produces a flat actionable rules sheet for programmers — what you must do, what you…
git:20260622.695134d · audit A · 99 stars
propagate-design-change SKILL.md skill
striderza/opencodegamestudios · .agents/modules/architecture/skills/propagate-design-change/SKILL.md · When a GDD is revised, scans all ADRs and the traceability index to identify which architectural decisions are now…
git:20260622.695134d · audit A · 99 stars
art-bible SKILL.md skill
striderza/opencodegamestudios · .agents/modules/art/skills/art-bible/SKILL.md · Guided, section-by-section Art Bible authoring. Creates the visual identity specification that gates all asset…
git:20260622.695134d · audit A · 99 stars
art-generate SKILL.md skill
striderza/opencodegamestudios · .agents/modules/art/skills/art-generate/SKILL.md · Generates placeholder .aseprite files from asset specs using the Aseprite MCP. Reads asset specs and art bible, creates…
git:20260621.096f040 · audit A · 99 stars
asset-audit SKILL.md skill
striderza/opencodegamestudios · .agents/modules/art/skills/asset-audit/SKILL.md · Audits game assets for compliance with naming conventions, file size budgets, format standards, and pipeline…
git:20260621.c7008e7 · audit A · 99 stars
asset-spec SKILL.md skill
striderza/opencodegamestudios · .agents/modules/art/skills/asset-spec/SKILL.md · Generate per-asset visual specifications and AI generation prompts from GDDs, level docs, or character profiles…
git:20260622.695134d · audit A · 99 stars
team-audio SKILL.md skill
striderza/opencodegamestudios · .agents/modules/audio/skills/team-audio/SKILL.md · Orchestrate audio team: audio-director + sound-designer + technical-artist + gameplay-programmer for full audio…
git:20260622.695134d · audit A · 99 stars
architecture-decision SKILL.md skill
striderza/opencodegamestudios · .agents/modules/core/skills/architecture-decision/SKILL.md · Creates an Architecture Decision Record (ADR) documenting a significant technical decision, its context, alternatives…
git:20260622.695134d · audit A · 99 stars
concept-brainstorm SKILL.md skill
striderza/opencodegamestudios · .agents/modules/core/skills/concept-brainstorm/SKILL.md · Guided game concept ideation — from zero idea to a structured game concept document. Uses professional studio ideation…
git:20260622.695134d · audit A · 99 stars
create-architecture SKILL.md skill
striderza/opencodegamestudios · .agents/modules/core/skills/create-architecture/SKILL.md · Guided, section-by-section authoring of the master architecture document for the game. Reads all GDDs, the systems…
git:20260622.695134d · audit A · 99 stars
gate-check SKILL.md skill
striderza/opencodegamestudios · .agents/modules/core/skills/gate-check/SKILL.md · Validate readiness to advance between development phases. Produces a PASS/CONCERNS/FAIL verdict with specific blockers…
git:20260622.a7ad6fe · audit A · 99 stars

Every file in striderza/opencodegamestudios

Other files named story-readiness

story-readiness SKILL.md skill
striderza/opencodegamestudios · .agents/modules/stories/skills/story-readiness/SKILL.md · Validate that a story file is implementation-ready. Checks for embedded GDD requirements, ADR references, engine notes…
git:20260622.695134d · audit A · 99 stars
story-readiness SKILL.md skill
furkantokkan/agent-foundry · plugins/agent-foundry/skills/story-readiness/SKILL.md · Validate that a story file is implementation-ready. Checks for embedded GDD requirements, ADR references, engine notes…
git:20260907.501dbca · audit A · 11 stars

Browse by kind, by grade A, or by owner.