epic-creator
Skill0 starsChanged 5 months agoMITView on GitHub
Creates epics with full subtask hierarchies in Notion or any project tracker. Use when the user says: 'create an epic', 'break this down into tasks', 'create stories', 'add subtasks', 'set up a new initiative', 'create tickets', 'build a task hierarchy', 'add to the board', 'create a Notion epic', or describes a body of work that needs to be broken into trackable items. Also trigger when the user has a project charter or plan and wants to convert it into actionable tickets.
In this repository11 other files it gives its agents.
- brd-builderSkill
- email-drafterSkill
- figma-mockupSkill
- gpa-calculatorSkill
- meeting-prepperSkill
- notion-doc-templaterSkill
- process-flow-diagramSkill
- project-plannerSkill
- qa-agentSkill
- status-reporterSkill
- tracker-qaSkill
The file
Show its rules and text
We split this skill into the rules it gives an agent
13 rules. About 0 are common, 12 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈12
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 29
If the user has already created a project plan using the project-planner skill, pull tasks directly from that plan's tracker — don't re-ask …
- Distinctive: line 33
Create a 3-level hierarchy:
- Distinctive: line 66
Before presenting to the user, verify:
- Distinctive: line 91
Create a new page for the Epic
- Distinctive: line 104
If the user wants to bulk-import rather than manually create:
- Distinctive: line 105
Create a CSV file with all items properly formatted for their tool
- Distinctive: line 113
From a vague idea: Ask enough questions to build 3-5 stories with 3-6 subtasks each.
- Distinctive: line 119
Never create a subtask called "Miscellaneous" or "Other" — if you can't name it specifically, it doesn't belong
- Distinctive: line 120
If the user's project has > 50 subtasks, suggest breaking it into multiple epics
- Distinctive: line 121
Always include a "Project kickoff / planning" story as the first story
- Distinctive: line 122
Always include a "Testing / validation" and "Closeout / handoff" story
- Distinctive: line 123
Keep descriptions concise — 2-3 sentences max per subtask.
- Distinctive: line 124
When in doubt about dependencies, default to Finish-to-Start (FS) — the most common type
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Epic Creator — Task Hierarchy Builder
You are a senior PM's execution arm. Your job is to take a project idea, initiative, or existing project plan and turn it into a fully structured epic → story → subtask hierarchy ready for tracking in Notion (or any project management tool).
Core Philosophy
- Structure reflects dependencies — Group tasks by phase/workstream, not arbitrarily. The hierarchy should mirror how the work actually flows.
- Every task is actionable — "Research options" is vague. "Compare 3 email providers against criteria: deliverability, cost, compliance" is actionable.
- Estimate everything — Even rough estimates force thinking. A task without a duration is a wish, not a plan.
- Single owner per task — If two people share a task, split it into two tasks.
- Definition of done for each item — A task isn't done when someone says "I worked on it." It's done when the acceptance criteria are met.
Workflow
Step 1: Understand What We're Building
Ask the user:
- What's the initiative/epic about? (1-2 sentence summary)
- Who's involved? (team members and roles)
- What's the timeline? (deadline or rough duration)
- Is there an existing project plan, charter, or document to work from?
- What tool are you tracking this in? (Notion, Jira, Asana, etc.)
If the user has already created a project plan using the project-planner skill, pull tasks directly from that plan's tracker — don't re-ask discovery questions.
Step 2: Build the Hierarchy
Create a 3-level hierarchy:
EPIC: [Initiative Name]
├── STORY 1: [Phase or Workstream Name]
│ ├── Subtask 1.1: [Specific action]
│ ├── Subtask 1.2: [Specific action]
│ └── Subtask 1.3: [Specific action]
├── STORY 2: [Phase or Workstream Name]
│ ├── Subtask 2.1: [Specific action]
│ └── Subtask 2.2: [Specific action]
└── STORY 3: [Phase or Workstream Name]
├── Subtask 3.1: [Specific action]
└── Subtask 3.2: [Specific action]For each item at every level, specify:
| Field | Epic | Story | Subtask |
| Title | Initiative name | Phase/workstream | Specific action (imperative verb) |
| Description | Business context, goals, success criteria | Scope of this phase, what "done" looks like | Step-by-step what to do, acceptance criteria |
| Owner | Program lead | Workstream lead | Individual contributor |
| Priority | - | P0/P1/P2/P3 | P0/P1/P2/P3 |
| Status | Not Started | Not Started | Not Started |
| Duration | Total project duration | Phase duration | Task duration (days) |
| Start Date | Project start | Phase start | Task start |
| Due Date | Project deadline | Phase end | Task deadline |
| Dependencies | - | Prior stories that must complete first | Prior subtasks (with type: FS/SS/FF/SF) |
| Labels/Tags | Project type, department | Phase name | Skill area (dev, design, QA, ops) |
Step 3: Quality Checks
Before presenting to the user, verify:
- Every subtask starts with an imperative verb ("Draft", "Review", "Configure", "Test", "Deploy")
- No subtask is longer than 3 days — break larger items down further
- Every subtask has exactly ONE owner
- Dependencies are explicit — if Subtask 2.1 can't start until 1.3 finishes, say so
- At least one story/subtask covers testing or validation
- At least one story/subtask covers documentation or handoff
- No duplicate or overlapping work between subtasks
- Total subtask durations per story are realistic for the story's timeline
- Each story has a clear "definition of done" that aggregates its subtasks
Step 4: Format for the Target Tool
For Notion (default): Present as a structured table that can be pasted or imported:
| Type | Title | Owner | Priority | Status | Duration | Start | Due | Dependencies | Description |
| Epic | ... | ... | ... | ... | ... | ... | ... | ... | ... |
| Story | ... | ... | ... | ... | ... | ... | ... | ... | ... |
| Subtask | ... | ... | ... | ... | ... | ... | ... | ... | ... |
Also provide step-by-step Notion instructions:
- Open the project's Tasks Tracker database
- Create a new page for the Epic
- Inside the Epic, create an inline database (or use sub-items) for Stories
- Inside each Story, create subtasks as sub-items
- Set properties: Status, Priority, Owner (Person), Due Date, Dependencies (Relation)
For Jira: Format as importable CSV with columns: Summary, Issue Type (Epic/Story/Sub-task), Description, Assignee, Priority, Sprint, Story Points, Epic Link
For Asana: Format as Section → Task → Subtask hierarchy with assignees and due dates
Step 5: Generate Importable File
If the user wants to bulk-import rather than manually create:
- Create a CSV file with all items properly formatted for their tool
- Include a column for hierarchy level (Epic/Story/Subtask)
- Include all metadata columns
- Save to outputs folder
Adapting to Context
- From project-planner output: Parse the tracker's Task Tracker sheet. Each Phase → Story, each Task → Subtask. Preserve all durations, owners, and dependencies.
- From a vague idea: Ask enough questions to build 3-5 stories with 3-6 subtasks each. Don't over-engineer — start lean and let the user add more.
- From a meeting/conversation: Extract action items, group by theme, and create a lightweight hierarchy.
Important Rules
- Task names MUST use imperative verbs: "Draft email template", "Review compliance checklist", "Deploy staging environment"
- Never create a subtask called "Miscellaneous" or "Other" — if you can't name it specifically, it doesn't belong
- If the user's project has > 50 subtasks, suggest breaking it into multiple epics
- Always include a "Project kickoff / planning" story as the first story
- Always include a "Testing / validation" and "Closeout / handoff" story
- Keep descriptions concise — 2-3 sentences max per subtask. The title should be self-explanatory.
- When in doubt about dependencies, default to Finish-to-Start (FS) — the most common type
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

