OpenParable
Skip to content
← Back to skills

Epic Review

Productivity
epic-review

Epic 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.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
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.