Skip to content
Skills Library
AI & agents · Automation

workflow-runner

/workflow-runner

Explicit-use only — invoke when the user explicitly names this skill, or when an active explicitly invoked workflow calls it. Runs an explicitly selected workflow through its own completion criteria without stopping between phases.

Author
fx ↗
Repository
cc ↗
Licence
MIT
Last repository change
08.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 08.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Explicit-use only — invoke when the user explicitly names this skill, or when an active explicitly invoked workflow calls it. Runs an explicitly selected workflow through its own completion criteria without stopping between phases.

Original author description

Explicit-use only — invoke when the user explicitly names this skill, or when an active explicitly invoked workflow calls it. Runs an explicitly selected workflow through its own completion criteria without stopping between phases.

How it works

  1. Purpose
  2. Execution Model
  3. Common Workflows
  4. Key Behaviors
  5. Scope Boundary (the one reason to stop)
Original SKILL.md headings · 54 lines, 293 words
SKILL.md preview
---
name: workflow-runner
description: "Explicit-use only — invoke when the user explicitly names this skill, or when an active explicitly invoked workflow calls it. Runs an explicitly selected workflow through its own completion criteria without stopping between phases."
---

# Workflow Runner Skill

## Purpose
Execute multi-step workflows to completion, looping until success.

## Execution Model
```python
while not workflow_complete:
    for phase in workflow_phases:
        result = execute_phase(phase)
        if result.needs_iteration:
            iterate_until_success(phase)
    check_completion_criteria()
```

## Common Workflows

### PR Iteration Loop
```
while not pr_ready:
    if size_exceeded:
        break_into_smaller_prs()
    if has_review_comments:
        address_feedback()
    if checks_failing:
        fix_failures()
    re_review()
```

### Multi-PR Coordination
- Work on next PR while previous awaits review
- Parallel execution when tasks independent
- Track all PR statuses
- Ensure all merge before final PR

## Key Behaviors
- NEVER stop mid-workflow
- Loop until success criteria met
- Launch sub-agents with appropriate skills to fix issues
- Maintain momentum on multi-PR work
- Update status continuously
- Carry the Scope Brief verbatim into every sub-agent and every reviewer call

## Scope Boundary (the one reason to stop)

"Never stop mid-workflow" means **iterations, duration, and effort are never reasons to stop** — that is the whole point of this skill. It does not mean the workflow may grow past what the user asked for.

Hold a **Scope Brief** for the run (definition: `fx-dev/skills/dev/references/scope-contract.md`) carrying the user's verbatim request, the interpreted scope, and an explicit out-of-scope list. Pass it into every sub-agent and every reviewer invocation; a reviewer that does not know what was asked for reports the work you deliberately did not do, and filtering that noise costs a full iteration each time.

Stop and inform the user **only** when the mission itself requires something outside that scope: an unmade architectural decision, a migration or breaking change the request never implied, or a destructive action. Finish everything inside scope first, then report the blocked remainder.

Remember: Complete the mission, no matter how many iterations — but complete *the* mission, not a larger one.

Versions

RepositoryScoreLicence
This page · fx/cc100MIT
jnmetacode/superpowers-zh100MIT

Database snapshot: 13.11.2026 · package version b7fe23931903 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100skill-creator
    Explicit-use only — invoke when the user explicitly names this skill, or when an active explicitly invoked workflow calls it. Guides explicitly requested creation or modification of a skill and its bundled resources.
  • 100managing-mcp-servers
    Explicit-use only — invoke when the user explicitly names this skill, or when an active explicitly invoked workflow calls it. Provides guidance for explicitly requested Claude MCP server management.
  • 100infer-completion-criteria
    Infer measurable completion criteria for an agent-loop task from project docs, code, and AIWG standards when the user has not supplied --completion explicitly
  • 100infer-completion-criteria
    Infer measurable completion criteria for an agent-loop task from project docs, code, and AIWG standards when the user has not supplied --completion explicitly
  • 90persistent-completion-loop
    Use when a task must run to verified completion rather than best effort -- the user says "don't stop", "must complete", "finish this", or "keep going until done", or the work spans multiple iterations and needs reviewer sign-off before being called done.
  • 100ultragoal-goal
    Ultragoal for Codex. Use when the user asks for ultragoal in Codex, a hook-backed or runner-backed Codex goal loop, a rubric-backed Codex /goal, durable goal execution, evidence-led completion, panel verification, or to turn a brain dump into a Codex-native goal. Do not use for…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.