create-epics-stories

Convert PRDs and architecture documents into epics and user stories with acceptance criteria.

Updated Jan 29, 2026
One-click install
npx skills add https://github.com/GuidoBergman/aegish --skill create-epics-stories
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-epics-stories
Source: https://github.com/GuidoBergman/aegish/tree/main/.claude/skills/create-epics-stories
Command: npx skills add https://github.com/GuidoBergman/aegish --skill create-epics-stories

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill streamlines the product development process by converting high-level Product Requirements Documents (PRDs) and architectural decisions into detailed, implementation-ready epics and user stories.

Core Features & Use Cases

  • Requirement Decomposition: Breaks down complex requirements into manageable epics and granular user stories.
  • Acceptance Criteria Generation: Automatically creates comprehensive acceptance criteria for each story, ensuring clarity for development teams.
  • Contextual Integration: Incorporates technical and design context from PRD and architecture documents into story definitions.
  • Use Case: A product manager can input a new feature PRD and architecture document, and this Skill will generate a set of epics and user stories, complete with acceptance criteria, ready for the engineering backlog.

Quick Start

Use the create-epics-stories skill to transform the attached 'new-feature-prd.md' and 'architecture-doc.md' into development stories.

Frequently Asked Questions about create-epics-stories

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

FAQPage Schema
How do I generate user stories from a PRD and architecture document?

To generate user stories from a PRD, input both the complete product requirements document and architecture document into the workflow. The system processes these high-level specifications to decompose complex requirements into organized epics and granular user stories with contextual integration.

Can I automatically create acceptance criteria for agile development stories?

Yes, you can automatically create acceptance criteria for agile development stories. The workflow analyzes your technical and design context to generate comprehensive acceptance criteria for each user story, ensuring development teams have implementation-ready clarity.

What is the best way to break down complex product requirements into epics?

The best way to break down complex product requirements into epics is by processing complete PRD and architectural decisions together. This requirement decomposition bridges the gap between high-level specifications and actionable development tasks, yielding organized epics for the engineering backlog.

Do I need a complete PRD to decompose requirements into implementation-ready stories?

Yes, you need a complete PRD and architecture documentation as input to generate implementation-ready stories. The workflow relies on fully specified product requirements and architectural decisions to accurately create granular user stories with comprehensive acceptance criteria.

How does requirement decomposition handle technical context from architecture decisions?

Requirement decomposition handles technical context through contextual integration. It incorporates technical and design context directly from your PRD and architecture documents into the user story definitions, ensuring the generated development tasks align with architectural constraints.

What limitations exist when transforming product requirements into epics and user stories?

A key limitation is the strict dependency on complete input documentation. Without fully detailed PRD and architecture documents, the workflow cannot accurately generate implementation-ready epics, granular user stories, or the associated acceptance criteria for the development backlog.