skills.rest
pwretmo
pwretmoCOMMUNITY
Explore all skills by this author →
GitHub

issue-review-workflow

Automate three-pass GitHub issue reviews to tighten issue trees for implementation readiness.

Updated Mar 21, 2026
Search Tags:#workflow#documentation#github#epics#sub-issues#issue-review#three-pass
One-click install
npx skills add https://github.com/pwretmo/deep-underworld --skill issue-review-workflow
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: issue-review-workflow
Source: https://github.com/pwretmo/deep-underworld/tree/main/.github/skills/issue-review-workflow
Command: npx skills add https://github.com/pwretmo/deep-underworld --skill issue-review-workflow

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This guide defines a repeatable workflow to review GitHub issues and epics, tighten acceptance criteria, and restructure issue trees for clear implementation paths.

Core Features & Use Cases

  • Three-pass review: architect, engineer, and writer passes to produce a clean, implementable issue tree.
  • Recursive issue analysis: reads root issues and all sub-issues, surfacing dependencies and overlap.
  • Research and documentation discipline: performs targeted web research when needed and updates issue bodies/comments with recommended solutions.
  • Issue governance: splits oversized work, consolidates duplicates, links related issues, and defines explicit acceptance criteria and next actions.
  • Auditable workflow: provides a structured body template and return formats to ensure traceability.

Quick Start

Initiate a three-pass review to tighten a GitHub issue into an implementation-ready plan.

Frequently Asked Questions about issue-review-workflow

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

FAQPage Schema
How do I review and tighten GitHub epics and sub-issues for implementation readiness?▼

Review GitHub epics and sub-issues by applying a three-pass architect, engineer, and writer workflow that recursively reads issue trees, performs web research, and updates bodies until ready for coding.

What is the best way to restructure a GitHub issue tree with overlapping or duplicate sub-issues?▼

Restructure a GitHub issue tree by recursively analyzing root issues and sub-issues to surface dependencies, split oversized work, consolidate duplicates, and define explicit acceptance criteria.

Can I automate updating GitHub issue bodies and comments with recommended solutions?▼

Yes, you can automate updating GitHub issue bodies and comments by applying an explicit update policy that writes recommended solutions and next actions into a structured body template for traceability.

How does the three-pass issue review workflow handle complex epics?▼

The three-pass issue review workflow handles complex epics by having the architect, engineer, and writer passes recursively read all sub-issues, perform targeted web research, and split or consolidate work.

Do I need a specific GitHub setup to apply recursive issue analysis and governance?▼

You need a GitHub repository with existing root issues, epics, or sub-issues to apply recursive issue analysis, as the workflow reads and updates these issue trees directly without requiring external dependencies.

Related Skills

Explore More Software Engineering Skills→
marcmontecalvomarcmontecalvo

work-next-issue-in-given-epic

Select and complete the next actionable child issue from a GitHub EPIC.

Community
Advanced
learnzdevelopmenthublearnzdevelopmenthub
1

dev-ship

Merge approved pull requests into develop and update issue boards.

Community
Advanced
scute-shscute-sh
3

issue-workflow

Manage GitHub issues from comprehension through PR creation and CI verification.

Official
Advanced
ourchitectureourchitecture
1

review-issues

Audit GitHub issues for clarity, completeness, and project standards.

Official
Advanced