agentleFS
schuliganschuligan/claude-skills-collection/skills/epic-creator/SKILL.md

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.

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
  1. Very specific:

    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 …

    line 29
  2. Distinctive:

    Create a 3-level hierarchy:

    line 33
  3. Distinctive:

    Before presenting to the user, verify:

    line 66
  4. Distinctive:

    Create a new page for the Epic

    line 91
  5. Distinctive:

    If the user wants to bulk-import rather than manually create:

    line 104
  6. Distinctive:

    Create a CSV file with all items properly formatted for their tool

    line 105
  7. Distinctive:

    From a vague idea: Ask enough questions to build 3-5 stories with 3-6 subtasks each.

    line 113
  8. Distinctive:

    Never create a subtask called "Miscellaneous" or "Other" — if you can't name it specifically, it doesn't belong

    line 119
  9. Distinctive:

    If the user's project has > 50 subtasks, suggest breaking it into multiple epics

    line 120
  10. Distinctive:

    Always include a "Project kickoff / planning" story as the first story

    line 121
  11. Distinctive:

    Always include a "Testing / validation" and "Closeout / handoff" story

    line 122
  12. Distinctive:

    Keep descriptions concise — 2-3 sentences max per subtask.

    line 123
  13. Distinctive:

    When in doubt about dependencies, default to Finish-to-Start (FS) — the most common type

    line 124

≈ “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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

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

  1. Structure reflects dependencies — Group tasks by phase/workstream, not arbitrarily. The hierarchy should mirror how the work actually flows.
  2. Every task is actionable — "Research options" is vague. "Compare 3 email providers against criteria: deliverability, cost, compliance" is actionable.
  3. Estimate everything — Even rough estimates force thinking. A task without a duration is a wish, not a plan.
  4. Single owner per task — If two people share a task, split it into two tasks.
  5. 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:

FieldEpicStorySubtask
TitleInitiative namePhase/workstreamSpecific action (imperative verb)
DescriptionBusiness context, goals, success criteriaScope of this phase, what "done" looks likeStep-by-step what to do, acceptance criteria
OwnerProgram leadWorkstream leadIndividual contributor
Priority-P0/P1/P2/P3P0/P1/P2/P3
StatusNot StartedNot StartedNot Started
DurationTotal project durationPhase durationTask duration (days)
Start DateProject startPhase startTask start
Due DateProject deadlinePhase endTask deadline
Dependencies-Prior stories that must complete firstPrior subtasks (with type: FS/SS/FF/SF)
Labels/TagsProject type, departmentPhase nameSkill 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:

TypeTitleOwnerPriorityStatusDurationStartDueDependenciesDescription
Epic...........................
Story...........................
Subtask...........................

Also provide step-by-step Notion instructions:

  1. Open the project's Tasks Tracker database
  2. Create a new page for the Epic
  3. Inside the Epic, create an inline database (or use sub-items) for Stories
  4. Inside each Story, create subtasks as sub-items
  5. 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

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.