create-epic

Creates a GitHub epic with parent and child sub-issues from an implementation plan.

3|Updated Feb 15, 2025
One-click install
npx skills add https://github.com/mark-torres10/ai_tools --skill create-epic-mark-torres10
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-epic
Source: https://github.com/mark-torres10/ai_tools/tree/main/skills/create-epic
Command: npx skills add https://github.com/mark-torres10/ai_tools --skill create-epic-mark-torres10

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a multi-step implementation plan into trackable GitHub issues is tedious and error-prone: you must create a parent tracking issue, one child issue per plan step, wire up real blocking dependencies, and keep everything consistent. This Skill automates that entire filing workflow while preventing duplicates and premature implementation. ## Core Features & Use Cases - Plan-to-Epic Conversion: Reads a plan package (plan.md plus expanded steps/*.md) and proposes one parent issue plus one child sub-issue per step, where each child maps to exactly one future PR. - Duplicate Detection: Searches existing open issues for the plan title before creating anything, avoiding duplicate epics. - Approval-Gated Creation: Presents a proposal table with titles, dependencies, and split/merge recommendations, then waits for explicit approval before a single subagent performs all GitHub mutations via gh. - Use Case: After finalizing a five-step implementation plan, invoke /create-epic to file a tracking epic with five child issues, real blocked-by edges, and a plan-only PR referencing all issues. ## Quick Start Invoke /create-epic after your implementation plan is complete to file the GitHub epic and child issues.

Frequently Asked Questions about create-epic

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

FAQPage Schema
How do I create a GitHub epic with sub-issues from a plan?

Invoke /create-epic with a complete plan package containing plan.md and expanded steps files. The skill proposes a parent issue plus one child per step, waits for your approval, then creates them via the gh CLI with real blocked-by dependencies.

How do I break an implementation plan into GitHub issues for PRs?

Each plan step becomes one child issue scoped to exactly one future PR. The skill enforces that every step is independently reviewable and mergeable, and recommends splits or merges only as questions before you approve.

Does create-epic check for duplicate GitHub issues before creating them?

Yes. It searches open issues for the plan title as a parent or an existing parent holding those child titles. If found, it shows the URLs and asks whether to add missing children or abort, never creating duplicates.

Can create-epic open PRs or implement the plan steps?

No. It only files issues and optionally opens one PR containing the plan documents with no product code. Implementation is handled separately by implement-plan-and-open-pr or /implement-epic, one child issue at a time.

What happens if my plan package is incomplete when filing an epic?

If plan.md or expanded steps are missing, the skill first runs the create-implementation-plan workflow to produce the full package. It will not propose GitHub issues until a complete plan package exists.