mcpField
W
workflow-builder

workflow-builder

github.com/somnio-softwareAgent workflows8132 installsUpdated 2w ago
Repository

About workflow-builder

workflow-builder is an agent skill for designing and running repeatable, multi-step AI workflows. It supports model assignment by step and runs independent steps in parallel waves.

Key features

  1. 01Plan or run workflows
  2. 02Resume existing workflows
  3. 03Assign models by tag
  4. 04Run independent steps in parallel
  5. 05Pass outputs between steps

Use cases

  1. 01Design a multi-step AI workflow
  2. 02Execute or resume a saved workflow
  3. 03Run independent research steps concurrently

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/somnio-software/somnio-ai-tools --skill workflow-builder

After installing, type/workflow-builderin Claude Code to confirm it loaded.

Bundled filesreferences/plan.mdreferences/run.md

Details

From the project README

Workflow Builder

Create and execute custom, repeatable multi-step AI workflows. Each step can use a different model, and independent steps run in parallel waves.

Capabilities

This skill has two modes:

ModeWhen to useReference
PlanUser wants to create or design a new workflowreferences/plan.md
RunUser wants to execute, resume, or re-run a workflowreferences/run.md

Quick Start

  • Create: "Create a workflow called dependency-cleanup"
  • Run: "Run the dependency-cleanup workflow"
  • Resume: "Resume the dependency-cleanup workflow"

Routing

Determine the user's intent from their message or $ARGUMENTS:

  1. If the user says "create", "plan", "design", or "new workflow" → Read and follow references/plan.md

  2. If the user says "run", "execute", "start", or "resume" → Read and follow references/run.md

  3. If $ARGUMENTS starts with plan → Read and follow references/plan.md with the remaining argument as workflow name

  4. If $ARGUMENTS starts with run → Read and follow references/run.md with the remaining argument as workflow name

  5. If unclear, ask the user: "Would you like to create a new workflow or run an existing one?"

Workflow Structure

A workflow is a directory at .somnio/workflows/<name>/ containing:

.somnio/workflows/<name>/
├── context.md              — Manifest with step list and metadata
├── 01-<step-name>.md       — Step 1 prompt
├── 02-<step-name>.md       — Step 2 prompt
├── ...
├── config.claudecode.json  — Model assignments (optional)
├── progress.json           — Execution state (auto-generated)
└── outputs/                — Step output files (auto-generated)

Key Concepts

  • Steps run in fresh AI contexts (separate subagents)
  • Tags (research, planning, execution) map to model assignments
  • Dependencies (needs) determine parallel wave grouping
  • Placeholders ({output_path}, {step_N_output}) enable data flow between steps
  • Independent steps with no needs run concurrently in the same wave

Comments

Markdown supported