# Epic Review

> Authoritative protocol for pre-work review of epics. Six-stage gating chain — roadmap fit, approach elegance, source discussion mapping, sub-structure coherence, prescription layer, avoided-traps completeness — posted as a structured comment on the epic ticket. Per-agent-per-epic one-shot; subsequent sub pickups cite the prior review. Triggers: Use this skill when an agent is about to pick up its first sub from an unreviewed epic (per model-identity OTHER than the epic's author — you never review your own epic). Also use when a user explicitly requests an epic review, or when an epic is freshly filed and a reviewer pre-validates before any sub pickup begins. Participated in the source Discussion? The participant path narrows the chain; it never exempts it.

- Skill: `neomjs/epic-review` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add neomjs/epic-review`
- Raw SKILL.md: https://api.skillmd.com/api/skills/neomjs/epic-review/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: neomjs (https://skillmd.com/u/neomjs)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/neomjs/epic-review

---

# Epic Review Skill

If you are about to pick up your first sub-issue from an epic that your model-identity has not yet reviewed, you MUST immediately use the `view_file` tool to read and strictly adhere to `.agents/skills/epic-review/references/epic-review-workflow.md` before running `ticket-intake` or any sub-work steps.

Subsequent sub pickups from the same epic by the same model-identity cite the prior review by URL reference instead of re-running the skill.

Authored this epic yourself, or participated in its source Discussion? Read `references/participant-path.md` first.