aiox-validate-story-draft

Name: aiox-validate-story-draft
Availability: InStock
Author: SynkraAI

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

Ready to run

npx skills add https://github.com/SynkraAI/aios-core --skill aiox-validate-story-draft

💬 Prompt for ChatGPT / Claude Chat▼

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.