Epic Review
Productivityepic-reviewEpic Review is an Agent Skill for productivity published in the neomjs/neo repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
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). 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.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/neomjs/neo/blob/HEAD/.agents/skills/epic-review/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/epic-review, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
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.