until

Loop a stage and stop once a predicate is satisfied — `do … until (cond)`: the body runs FIRST, then the condition is checked. The loop always runs at least once. Full loop safety: hard cap on iterations, convergence detection (stops if output stops changing), and a clean kill switch. USE when the user wants semantic termination after acting — "fix the build until it passes", "extract issues until none remain", "retry until it succeeds". For checking the condition BEFORE running (the body may not run at all), use `/agentflow:while`. For a fixed count, use `/agentflow:repeat`.

Jump to install

Repository: AleSaiani/agentflow
Last source activity: May 25, 2026 at 18:30
Detected SKILL.md language: English
Stars: 5
Forks: 0

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/AleSaiani/agentflow --skill until

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

name	until
user-invocable	false
description	Loop a stage and stop once a predicate is satisfied — `do … until (cond)`: the body runs FIRST, then the condition is checked. The loop always runs at least once. Full loop safety: hard cap on iterations, convergence detection (stops if output stops changing), and a clean kill switch. USE when the user wants semantic termination after acting — "fix the build until it passes", "extract issues until none remain", "retry until it succeeds". For checking the condition BEFORE running (the body may not run at all), use `/agentflow:while`. For a fixed count, use `/agentflow:repeat`.
allowed-tools	Bash, Read, Agent
argument-hint	--stage "<bash>" --stop "<bash predicate>" [--max-iterations N]

/agentflow:until — do…until loop

Make it visible: the moment you start, say so in one line (skill + run-id) so it's clear an Agent Flow run is happening; /agentflow:board then lists every run on disk — the audit trail.

Engine: iterate. until mode: the stop predicate exits 0 when satisfied → stop.

Init

node "${CLAUDE_PLUGIN_ROOT}/dist/state/iterate.js" init <run-id> \
  --stage "<body command>" \
  --stop  "<predicate command>" \
  [--max-iterations <N>] [--no-convergence-check]

--stage and --stop take plain bash commands (--mode defaults to until here). The predicate exits 0 when satisfied → stop.

Drive (one iteration per turn)

node "${CLAUDE_PLUGIN_ROOT}/dist/state/iterate.js" run-iteration <run-id>

Order per iteration: run the stage, then check the predicate. action: "continue" → end the turn (Stop hook resumes); action: "stop" → surface the result. reason is one of predicate_satisfied | max_iterations | convergence | stage_failed | killed. The predicate sees ITER_OUTPUT_PATH (this iteration's stdout) and ITER_PREV_OUTPUT_PATH.

until

Source facts

Install options

Review the source files

More from this repository

More from this repository

/agentflow:until — do…until loop

Init

Drive (one iteration per turn)

/agentflow:until — do…until loop

Init

Drive (one iteration per turn)