workflow-runner

Executes agency-orchestrator YAML workflows with multi-role agents inside the current AI session.

Updated Jun 11, 2026
One-click install
npx skills add https://github.com/marcocpt/trae_skills --skill workflow-runner-marcocpt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: workflow-runner
Source: https://github.com/marcocpt/trae_skills/tree/main/workflow-runner
Command: npx skills add https://github.com/marcocpt/trae_skills --skill workflow-runner-marcocpt

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Running agency-orchestrator YAML workflows normally requires a CLI setup with API keys. This Skill lets you execute multi-role orchestration workflows directly inside Claude Code, OpenClaw, or Cursor, using the current session's LLM as the execution engine. ## Core Features & Use Cases - YAML Workflow Execution: Parses workflow files with inputs, steps, roles, and dependency graphs, then executes them layer by layer with topological ordering. - Multi-Role Orchestration: Reads agent role definitions from agency-agents-zh and impersonates each role with its expertise and communication style, running parallel steps via sub-agents. - Structured Output Persistence: Saves per-step outputs, a final summary, and metadata.json into a dated .ao-output directory. - Use Case: A user provides a story-creation.yaml workflow where a narrator, psychologist, and editor collaborate; the Skill runs each role in dependency order and delivers the final story plus all intermediate outputs. ## Quick Start Run the workflow defined in workflows/story-creation.yaml using the agency-agents-zh role definitions.

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 workflow, loads role definitions from agency-agents-zh, and executes each step using the current session's LLM as the engine.

How do I orchestrate multiple AI agent roles in one session?

Define steps with role paths, tasks, and depends_on fields in a YAML workflow, or describe the collaboration in natural language. The Skill builds a topological execution plan and impersonates each role in dependency order, running independent steps in parallel via sub-agents.

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

Execution stops and the Skill prompts you to install the roles via git clone from the agency-agents-zh repository or npm install agency-agents-zh. It 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 you need, such as having a product manager and architect review a PRD, and the Skill 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.