gaia-create-epics

Generate epics and user stories with dependency topology from PRD and architecture.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This skill orchestrates translating a PRD and architecture into a structured set of epics and user stories by coordinating the architect and PM subagents, enabling end-to-end planning alignment.

Core Features & Use Cases

  • Orchestrates epic decomposition with Theo (architect) and Derek (pm)
  • Generates dependency topology, risk scores from the test plan, and prioritized backlog
  • Writes the final epics-and-stories document to docs/planning-artifacts/epics-and-stories.md

Quick Start

Provide the PRD and architecture documents, run the skill, and retrieve docs/planning-artifacts/epics-and-stories.md.

Frequently Asked Questions about gaia-create-epics

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

FAQPage Schema
How do I decompose a PRD into agile epics and user stories?

To decompose a PRD into epics and user stories, this skill orchestrates architect and PM subagents to transform your PRD and architecture into a structured set of epics and stories with dependency topology and risk-aware prioritization, writing the final backlog to epics-and-stories.md.

What is the best way to generate a dependency topology for a sprint backlog?

Generating a dependency topology for a sprint backlog requires analyzing architecture and test plans to map story dependencies and blocks. This skill automates that mapping, assigning risks and priorities to each story for sprint planning readiness.

Do I need architecture and test plan documents to generate epics and stories?

Yes, you need architecture and test plan documents to generate epics and stories. The skill loads required upstream artifacts including prd.md, architecture.md, and test-plan.md, plus an optional ux-design.md, to ensure governance gates are enforced.

Can I prioritize user stories based on risk scores from a test plan?

Yes, you can prioritize user stories based on risk scores from a test plan. The skill delegates risk-aware prioritization by extracting risk data from the test plan and assigning priority levels to each story for sprint planning readiness.

How to ensure governance gates are enforced when translating a PRD into epics?

Ensuring governance gates are enforced when translating a PRD into epics requires a coordinated workflow between architect and PM subagents. This skill orchestrates that delegation, verifying each story declares dependencies and blocks before writing the final document.

What limitations exist when using subagents for agile epic decomposition?

A key limitation of using subagents for agile epic decomposition is the strict dependency on upstream artifact formatting. The skill requires prd.md, architecture.md, and test-plan.md in the docs/planning-artifacts directory, and cannot operate without them.