gaia-create-story

Convert epics and stories into documented artifacts with YAML frontmatter and acceptance criteria.

2|Updated Apr 15, 2026
One-click install
npx skills add https://github.com/gaiastudio-ai/gaia-public --skill gaia-create-story
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gaia-create-story
Source: https://github.com/gaiastudio-ai/gaia-public/tree/main/plugins/gaia/skills/gaia-create-story
Command: npx skills add https://github.com/gaiastudio-ai/gaia-public --skill gaia-create-story

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires resolve-config.sh, validate-gate.sh, checkpoint.sh, lifecycle-event.sh, sprint-state.sh, and includes scripts (resource) components.

What problem does it solve?

Converts high-level epics and stories into fully documented story artifacts with frontmatter, acceptance criteria, and sprint-state integration, removing manual drafting errors.

Core Features & Use Cases

  • Converts planning artifacts from docs/planning-artifacts/epics-and-stories.md into structured implementation artifacts.
  • Writes to docs/implementation-artifacts/{story_key}-{slug}.md with all required frontmatter fields and formatted acceptance criteria.
  • Registers story status via sprint-state tooling to maintain backlog/sprint alignment.

Quick Start

Run the GAIA Create Story workflow with a story key to generate the implementation artifact.

Frequently Asked Questions about gaia-create-story

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

FAQPage Schema
How do I convert high-level epics into documented story artifacts with acceptance criteria?

Story documentation requires YAML frontmatter for metadata, Given/When/Then statements for acceptance criteria, and sprint-state registration for backlog alignment. This format maintains structure and traceability across implementation artifacts.

What's the best way to generate sprint stories from planning documentation?

Generating sprint stories from planning documentation is best handled by extracting epics from a planning markdown file and writing structured implementation artifacts. This enforces consistent frontmatter, acceptance criteria, and sprint-state registration.

Do I need a specific planning file structure to generate story artifacts with frontmatter?

Yes, generating story artifacts requires a specific planning file structure. You need an input file containing high-level epics and stories to extract from, ensuring the output implementation artifact receives all required YAML frontmatter fields and acceptance criteria.

How does sprint-state registration work when creating story documentation?

Sprint-state registration works by registering the newly created story status via bundled tooling during artifact generation. This maintains backlog and sprint alignment by linking the formatted implementation artifact directly to the active sprint state.

Can I use a template to enforce consistent story structure and acceptance criteria?

Yes, you can use a bundled template to enforce consistent story structure and acceptance criteria. This guarantees every generated implementation artifact includes required YAML frontmatter fields and Given/When/Then statements for traceability.