skills.rest
pnewsam
pnewsamCOMMUNITY
Explore all skills by this author →
Website𝕏@paultakumaGitHub

plan-epic-gaps

Creates a prioritized gap-closure plan from an epic audit report.

1|Updated Apr 15, 2026
Search Tags:#project management#audit#feature tracking#prioritization#gap analysis#epic planning#punch list
One-click install
npx skills add https://github.com/pnewsam/skills --skill plan-epic-gaps-pnewsam
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: plan-epic-gaps
Source: https://github.com/pnewsam/skills/tree/main/archive/plan-epic-gaps
Command: npx skills add https://github.com/pnewsam/skills --skill plan-epic-gaps-pnewsam

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After auditing an epic, teams are left with a raw list of discrepancies — missing feature plans, unchecked acceptance criteria, stale task lists, and orphaned files — with no clear order or owner for fixing them. This Skill turns those audit findings into a structured, prioritized punch list so every gap maps to a concrete action. ## Core Features & Use Cases - Gap Classification: Maps each audit finding to a typed gap (missing-plan, checkbox-mismatch, tracking-drift, orphan-plan, and more) with a default fix action. - Systemic Issue Detection: Identifies patterns repeating across 3+ features and consolidates them into a single process-level recommendation instead of per-feature items. - Prioritized Punch List: Orders actions by severity, dependency, and effort, and writes the plan to docs/epics/NNN-slug-gap-closure.md with decision points and an execution order. - Use Case: After running an epic audit that finds 12 gaps across 6 features, use this Skill to produce a plan that flags 2 decisions for humans, escalates a missing feature plan that blocks downstream work, and sequences the remaining fixes. ## Quick Start Read the audit report for epic 001 and create a prioritized gap-closure plan with a punch list and execution order.

Frequently Asked Questions about plan-epic-gaps

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

FAQPage Schema
How do I turn an epic audit report into an action plan?▼

Run this Skill after generating an audit report with audit-epic. It reads the report from docs/epics/, classifies every gap by type and severity, and writes a prioritized punch list with concrete fix actions to a gap-closure plan file.

What inputs does epic gap planning require?▼

It requires an audit report at docs/epics/NNN-slug-audit.md produced by audit-epic. If no audit report exists for the epic, the Skill stops and instructs you to run audit-epic first before planning.

Does the gap-closure plan modify feature plans or source code?▼

No. The Skill only writes a plan document and never modifies the epic, feature plans, or source code. Execution of the planned actions is left to the user or to the referenced skills such as plan-feature and build-feature.

How are systemic gaps handled differently from isolated gaps?▼

Gaps of the same type appearing across 3 or more features are treated as systemic process issues. They produce one consolidated recommendation covering all affected features instead of separate per-feature punch list items.

What happens if a gap-closure plan already exists?▼

The Skill reads the existing plan first and preserves items already marked complete. It only adds new gaps from the latest audit and updates severity ratings if they changed, making the operation idempotent.

When should I not use epic gap planning?▼

Skip it when the audit found no gaps, since the epic is healthy and there is nothing to plan. Also skip it when the epic has no child features; in that case define the child features first with plan-epic.

Related Skills

Explore More Product & Management Skills→
chris-prenerchris-prener

requirements

Drafts, amends, supersedes, and audits requirements documents under docs/requirements/.

Community
Intermediate
iamsteveholmesiamsteveholmes

feature-breakdown

Enumerate missing stories and gaps for feature delivery.

Community
Advanced
nathannorthcuttnathannorthcutt

feature-implement

Coordinate end-to-end feature implementation workflows from plan to completion.

Community
Advanced
subroh0508subroh0508
18

plan-author

Generate a PR-scoped plan document and update the plan index.

Community
Intermediate