workflow-runner

Executes explicitly selected multi-phase workflows to completion without stopping between phases.

Updated Nov 2, 2025
One-click install
npx skills add https://github.com/fx/skills --skill workflow-runner-fx
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: workflow-runner
Source: https://github.com/fx/skills/tree/main/skills/workflow-runner
Command: npx skills add https://github.com/fx/skills --skill workflow-runner-fx

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Multi-phase development workflows (PR iteration loops, multi-PR coordination) often stall between phases when an agent stops after each step, forcing the user to manually re-prompt for every iteration. This Skill runs an explicitly selected workflow through its own completion criteria, looping until success. ## Core Features & Use Cases - Continuous Phase Execution: Iterates through workflow phases, re-running any phase that needs iteration until its success criteria are met. - PR Iteration Loop: Handles oversized PRs, review comments, and failing checks in a loop until the PR is ready. - Multi-PR Coordination: Works on the next PR while previous ones await review, tracking all PR statuses until everything merges. - Scope Boundary Enforcement: Carries a Scope Brief (user's verbatim request, interpreted scope, out-of-scope list) into every sub-agent and reviewer call, stopping only when the mission requires something outside the requested scope. - Use Case: You ask an agent to get a feature branch fully merged. The Skill keeps addressing review feedback and fixing failing checks across as many iterations as needed, only pausing if the work requires an out-of-scope decision like a breaking change. ## Quick Start Explicitly invoke the workflow-runner skill and name the workflow you want run to completion, such as asking it to run the PR iteration loop until the pull request is ready to merge.

Frequently Asked Questions about workflow-runner

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

FAQPage Schema
How do I run a multi-step workflow to completion with an AI agent?▼

Explicitly invoke the workflow-runner skill and name the workflow to execute. It loops through each phase, re-running phases that need iteration, and checks completion criteria until the workflow's success conditions are met.

How do I automate PR review feedback and CI fix iterations?▼

Use the PR iteration loop workflow: it breaks up oversized PRs, addresses review comments, fixes failing checks, and re-requests review repeatedly until the PR is ready. The loop continues without stopping between iterations.

When does the workflow runner stop executing?▼

It never stops for iteration count, duration, or effort. It stops only when the mission requires something outside the user's requested scope, such as an unmade architectural decision, a breaking change, or a destructive action.

What is a Scope Brief in workflow execution?▼

A Scope Brief carries the user's verbatim request, the interpreted scope, and an explicit out-of-scope list. It is passed into every sub-agent and reviewer invocation so reviewers do not flag deliberately omitted work as missing.

Can the workflow runner coordinate multiple pull requests at once?▼

Yes. It works on the next PR while previous ones await review, runs independent tasks in parallel, tracks all PR statuses, and ensures everything merges before the final PR completes.