create-stories

Convert Accepted Epics and elicitation artifacts into sprint-ready User Stories with traceability.

Updated Apr 18, 2026
One-click install
npx skills add https://github.com/4797pnkkx5-gif/AI-Augmented-RE --skill create-stories-4797pnkkx5-gif
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-stories
Source: https://github.com/4797pnkkx5-gif/AI-Augmented-RE/tree/main/skills/create-stories
Command: npx skills add https://github.com/4797pnkkx5-gif/AI-Augmented-RE --skill create-stories-4797pnkkx5-gif

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents teams from getting stuck with accepted epics that never get decomposed into sprint-ready user stories with traceable acceptance criteria.

Core Features & Use Cases

  • Decomposes only Accepted Epics: Generates or refines one user-story per eligible accepted functional requirement, leaving pending/rejected epics untouched.
  • Lifts acceptance criteria verbatim: Inherits the functional acceptance criteria from the approved elicitation document so “definition of done” stays consistent.
  • Creates an audit-friendly index: Rebuilds an aggregated story index that includes story map, coverage matrix, and open questions.
  • Idempotent updates with review gates: Refines pending stories in place, protects accepted/rejected stories by appending review notes only.

Quick Start

Run create-stories to generate user-story files from the currently Accepted Epics in artifacts/02-epics and the Approved elicitation document in artifacts/01-elicitation.

Frequently Asked Questions about create-stories

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

FAQPage Schema
How do I generate sprint-ready user stories from accepted epics?

To generate sprint-ready user stories, the Skill decomposes accepted epics by creating one story-NNN Markdown file per eligible accepted functional requirement, lifting acceptance criteria verbatim from the approved elicitation document.

How does requirements traceability work when creating user stories?

Requirements traceability is maintained by mapping one user story per eligible accepted functional requirement and rebuilding a comprehensive stories index that includes a coverage matrix and aggregated open questions.

Can I refine pending user stories without losing accepted or rejected story data?

Yes, you can refine pending stories in place while protecting accepted or rejected stories; the Skill preserves immutable fields for finalized stories by only appending review notes to them.

Does generating user stories from epics require an approved elicitation document?

Yes, generating user stories requires both Accepted Epics in the artifacts directory and an Approved elicitation document to ensure acceptance criteria are lifted verbatim for consistent definition of done.

How are acceptance criteria and story points handled during agile planning artifact generation?

During artifact generation, acceptance criteria are lifted verbatim from the elicitation document, while AI provisional story points are computed automatically and open questions are aggregated with severity-based review blocking rules.

What happens to pending or rejected epics during user story generation?

Pending or rejected epics remain untouched during user story generation; the Skill exclusively targets Accepted Epics to ensure only eligible functional requirements are decomposed into sprint-ready stories.