skills.rest
SynkraAI
SynkraAIOFFICIAL
Explore all skills by this author →
GitHub

aiox-validate-story-draft

Validates story drafts against a checklist and transitions approved stories to Ready status.

3.1k|952|Updated Dec 9, 2025
Search Tags:#checklist#quality gate#product owner#story validation#story readiness#AIOX#AGILE
One-click install
npx skills add https://github.com/SynkraAI/aios-core --skill aiox-validate-story-draft
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: aiox-validate-story-draft
Source: https://github.com/SynkraAI/aios-core/tree/main/.grok/skills/aiox-validate-story-draft
Command: npx skills add https://github.com/SynkraAI/aios-core --skill aiox-validate-story-draft

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Development teams need a consistent quality gate to decide whether a story draft is ready for implementation, and manual review often skips checklist items or leaves story status inconsistent.

Core Features & Use Cases

  • Task-Driven Validation: Loads and executes the canonical validation task file (validate-next-story.md) as the single source of truth instead of inventing a parallel checklist.
  • GO / NO-GO Decision: Runs the story template or 10-point checklist, auto-fixes only mechanical gaps, and sets story Status to Ready on GO or leaves it as Draft with required fixes on NO-GO.
  • Interactive or Yolo Modes: Supports an interactive mode that confirms on ambiguity and a yolo mode that runs autonomously while logging decisions.
  • Use Case: A product owner finishes drafting a user story and asks the PO agent to validate it; the skill checks the story against the checklist, fixes minor mechanical issues, updates the Change Log, and marks the story Ready for development.

Quick Start

Validate the story draft at docs/stories/3.2.story.md in interactive mode and mark it Ready if it passes the checklist.

Frequently Asked Questions about aiox-validate-story-draft

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

FAQPage Schema
How do I validate a story draft before development starts?▼

Provide the story file path as the first argument and the skill loads the canonical validation task, runs the story template or 10-point checklist, and returns a GO or NO-GO decision. On GO it sets the story Status to Ready and appends a Change Log entry.

What is the difference between yolo and interactive mode in story validation?▼

Interactive mode asks for confirmation whenever the validation hits ambiguity, while yolo mode runs autonomously and logs its decisions in chat. Interactive is the default when no mode argument is given.

Can the story validation skill auto-fix issues in a draft?▼

It can auto-fix only mechanical gaps that the underlying task file explicitly allows, such as formatting or checklist mechanics. It will not invent acceptance criteria or change story scope.

Why does story validation leave my story in Draft status?▼

A NO-GO result means the story failed one or more checklist criteria, so the skill leaves the Status as Draft and lists the required fixes. Address those items and run validation again to reach Ready.

Can this skill mark a story as Done or push changes to git?▼

No. Setting Status to Done is explicitly forbidden, and git push or PR creation is delegated to the devops agent. The skill only transitions stories from Draft to Ready on a GO decision.

Related Skills

Explore More Product & Management Skills→
jupitermoneyjupitermoney

prd-to-epics

Convert PRDs into Jira-ready Epics and Stories with acceptance criteria.

Official
Intermediate
zoonkzoonk
146

zoonk-issue-writer

Convert implementation plans into GitHub-ready user stories with acceptance criteria.

Official
Advanced
ncptuanncptuan

bmad-check-implementation-readiness

Audit PRD, architecture, UX, and epics for implementation readiness.

Community
Advanced
bychrisrbychrisr

aiox-po

Manage product backlogs and user story lifecycles with automated validation and prioritization.

Community
Advanced