working-on-an-epic

Coordinates GitHub epic child issues across parallel Conductor workspaces into reviewable PR stacks.

5|Updated Nov 9, 2025
One-click install
npx skills add https://github.com/britt/agent-skills --skill working-on-an-epic-britt
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: working-on-an-epic
Source: https://github.com/britt/agent-skills/tree/main/skills/working-on-an-epic
Command: npx skills add https://github.com/britt/agent-skills --skill working-on-an-epic-britt

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Implementing a GitHub epic means juggling many child issues, their dependencies, and their pull requests at once. Doing it serially in one session is slow, and doing it ad hoc loses track of what is blocked, done, or stacked. This Skill turns the agent into a coordinator that fans child issues out to separate Conductor cloud workspaces, tracks each one in a ledger, links dependent PRs into GitHub stacks, and reports honest status back on the epic. ## Core Features & Use Cases - Dependency-aware fan-out: Resolves child issues from sub-issues, task lists, and back-references, maps Blocked by relationships into chains, and spawns up to 4 concurrent Conductor workspaces with contract-style prompt files. - Autonomous watching and unblocking: A single background polling loop classifies each child session via sentinel lines (EPIC-CHILD-DONE / EPIC-CHILD-BLOCKED), relays answers to how-questions, and escalates what-questions instead of inventing product decisions. - Stack management and verification: Links dependent PRs with gh stack link, cross-checks every done claim with gh pr view, detects undeclared file overlaps, and posts a final per-child report with deep links and landing instructions. - Use Case: A developer says "get epic #87 done." The Skill reads the epic, spawns Conductor workspaces for each ready child issue, grows chains as layers complete, and ends with a comment listing every PR, its stack, CI state, and any blocked or skipped children. ## Quick Start Ask the agent to work on or coordinate a specific GitHub epic by number or URL, for example: "Use the working-on-an-epic skill to drive epic #87 to reviewable PRs."

Frequently Asked Questions about working-on-an-epic

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

FAQPage Schema
How do I implement a GitHub epic with multiple child issues automatically?▼

Use this coordinator workflow: it reads the epic and every child issue, maps dependencies into chains, and spawns one Conductor workspace per child running the working-on-an-issue skill. Each child opens its own PR, and dependent PRs are linked into GitHub stacks for ordered review.

What is the difference between working-on-an-issue and working-on-an-epic?▼

working-on-an-issue implements a single GitHub issue hands-off in one session. working-on-an-epic never implements anything itself; it coordinates child issues across separate Conductor workspaces, each of which runs working-on-an-issue, and tracks them to reviewable PRs.

What tools are required to coordinate an epic with Conductor?▼

You need the conductor CLI authenticated (conductor auth whoami succeeds), the gh CLI authenticated, and the gh-stack extension installed via gh extension install github/gh-stack. CONDUCTOR_WORKSPACE_ID should be set so child workspaces inherit the project.

Can the coordinator implement one small child issue itself?▼

No. The skill explicitly forbids the coordinator from implementing any child, even a quick one, because a coordinator that implements stops watching the others. Every child is spawned as its own Conductor workspace, and hybrid requests are declined.

What happens when a child issue gets blocked or stalls?▼

Blocked children comment on their issue with what they need and emit an EPIC-CHILD-BLOCKED line; the coordinator records them as blocked and never works around them. Stalled sessions get one retry with a fresh session, and a second stall is recorded as failed and reported honestly.

Does the epic coordinator merge pull requests?▼

No. The PR is the approval gate for each child, and merging is always left to the reviewer. For stacked chains, the final report gives the landing instruction gh stack merge <stack-number>, which only the reviewer runs.