workflow-runner

Executes agency-orchestrator YAML workflows using the current session LLM as the engine.

3|1|Updated May 29, 2026
One-click install
npx skills add https://github.com/mambo-wang/CodingHub --skill workflow-runner-mambo-wang
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: workflow-runner
Source: https://github.com/mambo-wang/CodingHub/tree/main/.qoder/skills/workflow-runner
Command: npx skills add https://github.com/mambo-wang/CodingHub --skill workflow-runner-mambo-wang

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Running multi-agent YAML workflows normally requires a CLI runtime and API keys. This Skill lets you execute agency-orchestrator workflows directly inside Claude Code, OpenClaw, or Cursor, using the current conversation's LLM to play each role. ## Core Features & Use Cases - YAML Workflow Parsing: Reads workflow files, extracts inputs, steps, roles, and dependency graphs, then builds a layered topological execution plan. - Multi-Role Orchestration: Loads agent role definitions from agency-agents-zh, renders task templates with variables, and executes steps sequentially or in parallel via sub-agents. - Structured Output Persistence: Saves each step's output, a final summary, and metadata.json into a dated .ao-output directory. - Use Case: A user says "run workflows/story-creation.yaml" or "have a product manager and architect review this PRD" — the Skill parses or generates the workflow, collects required inputs, and executes each role step by step. ## Quick Start Run the workflow defined in workflows/story-creation.yaml using the roles from agency-agents-zh and save the results.

Frequently Asked Questions about workflow-runner

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run an agency-orchestrator YAML workflow without an API key?▼

Provide the YAML workflow file path in Claude Code, OpenClaw, or Cursor and ask to run it. The Skill parses the file, collects required inputs, and executes each step using the current session's LLM as the role engine.

How do I orchestrate multiple agent roles to collaborate on one task?▼

Define steps with role paths and depends_on fields in a YAML workflow, or describe the collaboration in natural language. The Skill generates the workflow, topologically sorts steps into layers, and runs independent steps in parallel via sub-agents.

What happens if the agency-agents-zh role directory is missing?▼

Execution stops and the user is prompted to install it via git clone or npm install agency-agents-zh. The Skill checks the working directory, parent directory, YAML-relative path, and node_modules before failing.

Can I run a multi-role workflow without writing a YAML file?▼

Yes. Describe the collaboration in natural language, such as asking a product manager and architect to review a PRD. The Skill auto-generates a YAML workflow definition, shows it for confirmation, then executes it.

What happens when a workflow step fails during execution?▼

The failed step is marked as failed and all downstream steps depending on it are skipped. Independent steps continue executing, and results are still saved to the .ao-output directory with per-step status in metadata.json.