What is workflow-builder?

A tool for defining and running repeatable processes in which multiple agents perform steps such as drafting, reviewing, deciding, and retrying. It uses the OpenColab command-line tool to manage workflow definitions, runs, saved state, and human approval points.

Use it to create agent workflows, run parallel reviews followed by a merge, build judge-and-retry loops, and oversee workflow runs.

It removes the need to coordinate multi-agent steps manually while keeping runs bounded and recorded. Human gates allow a person to approve or guide work at selected points.

workflow-builder — Skill for Claude Code and Codex by jimezsa

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent

npx skills add jimezsa/opencolab --skill workflow-builder

Clone the repo

git clone --depth 1 https://github.com/jimezsa/opencolab

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/skills/jimezsa/opencolab/workflow-builder/github.svg)](https://agentmods.dev/skills/jimezsa/opencolab/workflow-builder)

Your own site

<a href="https://agentmods.dev/skills/jimezsa/opencolab/workflow-builder"><img src="https://agentmods.dev/badge/skills/jimezsa/opencolab/workflow-builder/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/skills/jimezsa/opencolab/workflow-builder"><img src="https://agentmods.dev/badge/skills/jimezsa/opencolab/workflow-builder.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 30 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 1,422 The whole file, excluding the scripts and references it only reads on demand.

Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.00030	$0.01422
Opus 5.5	$0.00012	$0.00569
Sonnet 5.5	$0.00006	$0.00284
Haiku 4.5	$0.00003	$0.00142

Measured 1mo ago against content hash 9237f6287ebb, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

workflow-builder scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

projects/SKILLS/workflow-builder/SKILL.md · 159 lines

How it starts

The opening of the file, as written. The whole thing — 159 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Workflow Builder Skill

Use this skill when the user wants to compose multiple agents into a repeatable workflow such as draft → review → judge, judge-and-retry, parallel reviews followed by a merge, or any other bounded coordination of agents.

This skill authors and operates workflows through the OpenColab CLI. It is not the workflow engine itself. The CLI/runtime owns parsing, execution, persistence, and human gate handling.

Source of truth

Workflow definitions live at: projects/<project_id>/workflows/<workflow_id>/workflow.xml
Workflow runs live at: projects/<project_id>/workflows/<workflow_id>/runs/<run_id>/
Each run folder contains RUN.md (with YAML frontmatter), state.json, status.json, events.jsonl, inputs/initial.md, and steps/<step_id>/.

Never edit state.json, status.json, or events.jsonl by hand. They are written by the runtime.

Allowed step types

agent — runs one project agent with a generated prompt. Required: id, type="agent", agent, <prompt>. Optional: <output name="..." />.
decision — runs one project agent and expects a strict <workflow-decision action="..." next="..." reason="..." /> line in the response. Required: id, type="decision", agent, <prompt>, <choices>.
human_gate — pauses the run for human input. Required: id, type="human_gate", <prompt>. Optional: allow="approve,stop,retry,edit,branch".
merge — concatenates prior outputs into a single named value. Required: id, type="merge", at least one <input name="..." />, <output name="..." />.
terminate — explicitly ends the run with a status of success, failed, or stopped.

Loops must be bounded

Every <loop> requires at least one of:

maxIterations="<n>"
maxSteps="<n>"
maxRuntimeMinutes="<n>"

Unbounded loops are rejected during validation.

Prompt references

Inside any <prompt> you can use template variables:

${input.<name>} — values supplied when starting the run.
${<output_name>} — named outputs from prior steps (<output name="..." />).
${<step_id>.output> — fallback reference for any step's raw output text.

Read the full file on GitHub · 159 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

1mo ago First seen · 159 lines · 30 tokens per session scan A 9237f6287ebb

Subscribe to this mod's changes

workflow-builder is a skill published in the GitHub repository jimezsa/opencolab (11 stars, last pushed 20d ago), licensed MIT. It adds 30 tokens to every session and 1,422 once invoked, about $0.0001 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Building agents Planning agent-skills ai ai-agents automation deep-research search

bilibili_search

Search for videos on Bilibili using keyword queries generated from user interests.

whiteguo233/OpenBiliClaw · 20 tokens

analyze-constraints-readiness

Characterize what blocks a research target: readiness dimensions, obstacles, bottlenecks, resource gaps, causal constraints, dependencies, conflicts, removability, and mitigation pathways. Depth selects lightweight triage, readiness assessment, or causal/TOC-style constraint analysis.

yogsoth-ai/de-anthropocentric-research-engine · 59 tokens

workflow-builder