pr-iteration

Orchestrate end-to-end PR review cycles with external reviews and iterative fixes.

Updated Apr 17, 2026
One-click install
npx skills add https://github.com/ctxr-dev/agent-staff-engineer --skill pr-iteration-ctxr-dev
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pr-iteration
Source: https://github.com/ctxr-dev/agent-staff-engineer/tree/main/skills/pr-iteration
Command: npx skills add https://github.com/ctxr-dev/agent-staff-engineer --skill pr-iteration-ctxr-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Drives a PR from just opened to a green terminal state by coordinating external reviews, local code changes, and CI checks, while never auto-merging.

Core Features & Use Cases

  • End-to-end PR iteration: orchestrates review requests, CI polling, thread triage, fixes, and final reporting across multiple rounds.
  • Safety gates with human oversight: ensures merges occur only under human approval and surfaces final state to the team.
  • Cross-tool workflow: integrates with GitHub trackers, per-round reporting, and the local review cycle.

Quick Start

Run an end-to-end PR iteration loop on the target PR, requesting external review, monitoring CI, triaging threads, and iterating until all exit conditions are met without auto-merging.

Frequently Asked Questions about pr-iteration

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

FAQPage Schema
How do I automate a GitHub pull request review cycle without auto-merging?▼

Automating a GitHub pull request review cycle without auto-merging involves orchestrating end-to-end iterations that coordinate external reviews, CI polling, thread triage, and iterative fixes. This workflow drives the PR to a green terminal state while ensuring merges occur only under human approval.

What is the best way to triage code review threads and apply fixes across multiple rounds?▼

Triageing code review threads and applying fixes across multiple rounds is done through an end-to-end PR iteration loop. This process monitors CI checks, triages review threads, and applies local code changes iteratively until all exit conditions are satisfied.

Can I use GitHub GraphQL integration to track PR review state and generate per-round reports?▼

Yes, you can use GitHub GraphQL integration to track PR review state and generate per-round reports. This workflow supports GitHub tracker integration and outputs per-round reporting under the `.development/shared/reports` directory for team visibility.

Does this PR iteration workflow support stateful progression for tracking review cycles?▼

Yes, this PR iteration workflow supports stateful progression for tracking review cycles. It maintains local JSON state under `.development/local/pr-iteration` to track the progression of external reviews, local code changes, and CI checks across multiple rounds.

When should I not use an automated end-to-end PR review orchestration approach?▼

You should not use automated end-to-end PR review orchestration if your project requires immediate auto-merging upon CI success, as this workflow explicitly avoids auto-merging. It is designed for projects needing human oversight, thread triage, and iterative fixes before final approval.