workflow-creator

Build a saved workflow

A saved workflow is a small Ruby (mruby) script that runs on demand or on a schedule. Your job is to guide the user from a one-off description of what they want repeated to a saved, validated workflow. It takes one of two shapes, sometimes mixed in the same script:

• Skill chain — the script calls existing skills/recordings in order via recording(...) / skill(...), passing each one's output to the next's input. You are composing things that already exist.
• Primitive-composed — the script calls agent(...) directly (alone, or fanned out with parallel/pipeline) to do fresh sub-agent work that has no matching existing skill — e.g. "review this diff across 3 dimensions in parallel" or "run this check over every file in the list." There is nothing to inventory here; you're writing the orchestration from scratch, just not the agent-level logic (that's still an LLM call inside agent(...), not new Go/tool code).

Figure out which shape (or mix) fits before drafting anything — see Step 0.

The pieces you use

• agent(prompt, opts = {}) — run one sub-agent to completion, returns a String. opts[:schema] (a JSON-schema string) makes the reply come back as a JSON string matching it — parse it yourself with JSON.parse, unlike skill()'s schema results, which arrive already parsed.
• skill(name, params = {}, opts = {}) — runs one existing SKILL.md skill as a sub-agent and returns its result as native Ruby. opts[:schema] makes the reply come back structured (already parsed).
• recording(name, params = {}) — replays one existing browser recording deterministically and returns its declared outputs as a Ruby Hash.
• args — the workflow's input, a Ruby Hash, so the saved workflow is parameterizable and reusable.
• parallel(items) { |it| ... } / pipeline(items, *stages) — for fan-out or staged flows, over agent() / skill() / recording() calls.
• log(msg) / phase(title) — progress output, no effect on scheduling.
• The workflow tool — runs a script (in the background: returns a run id).
• workflow_save — persists the script as a named workflow.