validate-story

Validates story drafts against a 10-step blueprint and reports a GO/NO-GO decision.

1|Updated Oct 19, 2025
One-click install
npx skills add https://github.com/AcidicSoil/lms-llmsTxt --skill validate-story-acidicsoil
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: validate-story
Source: https://github.com/AcidicSoil/lms-llmsTxt/tree/main/.claude/skills/validate-story
Command: npx skills add https://github.com/AcidicSoil/lms-llmsTxt --skill validate-story-acidicsoil

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ensures that story drafts are complete, actionable, and auditable before handing to developers, reducing rework and miscommunication.

Core Features & Use Cases

  • Validates that the story template is complete (frontmatter, objective, context, acceptance criteria, tasks, dev notes, testing, and file lists)
  • Checks file structure and source-tree consistency against project guidelines
  • Maps acceptance criteria to concrete tasks and flags uncovered gaps
  • Detects potential anti-hallucinations by cross-referencing architecture/docs
  • Generates a concise GO/NO-GO validation report with readiness score and issue taxonomy

Quick Start

To start validation, invoke the validate-story skill on a drafted Markdown file (e.g., .claude/stories/epic/story.md) and review the generated report.

Frequently Asked Questions about validate-story

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

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

To validate a story draft, run a 10-step blueprint check covering template completeness, file structure, acceptance criteria, and anti-hallucination safeguards. The process outputs a GO/NO-GO decision, a readiness score, and categorized issues for critical, should-fix, and nice-to-have items.

What is a go-no-go readiness assessment for story documentation?

A go-no-go readiness assessment evaluates story documentation against a 10-step process to determine if it is complete and actionable. It generates a readiness score and a validation report detailing critical, should-fix, and nice-to-have items before development.

How do I check if acceptance criteria map to concrete dev tasks?

Checking acceptance criteria mapping involves cross-referencing the story draft against the defined tasks to flag uncovered gaps. The validation process ensures all acceptance criteria are satisfied by concrete tasks and identifies missing coverage.

How do I detect anti-hallucination risks in a story draft?

Detecting anti-hallucination risks involves cross-referencing the story draft against project architecture and docs. This validation step ensures the story aligns with existing project guidelines and flags potential hallucinations before development.

What does story template completeness validation include?

Story template completeness validation checks for frontmatter, objective, context, acceptance criteria, tasks, dev notes, testing, and file lists. It ensures the drafted Markdown file contains all required sections for an actionable development handoff.

Can I validate file structure and source-tree consistency in a story?

Yes, you can validate file structure and source-tree consistency by applying the 10-step validation process to the story draft. It checks the specified file lists against project guidelines to ensure structural alignment before development.