workflow-runner

Execute agency-orchestrator YAML workflows using the current session's LLM.

7.6k|721|Updated Mar 20, 2026
One-click install
npx skills add https://github.com/jnMetaCode/superpowers-zh --skill workflow-runner-jnmetacode
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: workflow-runner
Source: https://github.com/jnMetaCode/superpowers-zh/tree/main/skills/workflow-runner
Command: npx skills add https://github.com/jnMetaCode/superpowers-zh --skill workflow-runner-jnmetacode

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

在 AI 工具的当前会话中直接运行 agency-orchestrator 的 YAML 工作流,无需配置 API key,当前会话的 LLM 即充当执行引擎。

Core Features & Use Cases

  • 工作流解析与执行:从 YAML 中读取工作流定义,解析 names、agents_dir、inputs、steps 等字段,按拓扑顺序执行。
  • 角色对齐与上下文传播:定位角色目录,读取角色的系统提示,将输入变量与前序步骤输出渲染到任务文本中。
  • 分层执行与结果存档:按层级并行或串行执行步骤,输出写入上下文,最终汇总为可下载的结果。

Quick Start

在当前会话中提供 YAML 工作流文件,直接运行以在 AI 工具内进行多角色编排任务。

Frequently Asked Questions about workflow-runner

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

FAQPage Schema
How do I run multi-role agent workflows in Claude Code without an API key?

You can execute multi-role agent workflows by loading a YAML file into your current session. The session's LLM acts as the execution engine directly, parsing agents, inputs, and steps without requiring any external API key configuration.

What is YAML workflow orchestration for multi-role AI agents?

YAML workflow orchestration for AI agents defines names, agent directories, inputs, and execution steps in a YAML file. The orchestrator reads role prompts from predefined directories and executes tasks in topological order using the current LLM session.

Can I use Cursor to execute agency-orchestrator YAML files?

Yes, Cursor can execute agency-orchestrator YAML files directly. The workflow runner supports AI tools including Cursor, Claude Code, and OpenClaw, using the active session to render step tasks with prior outputs and enforce a fail-safe execution plan.

How are previous step outputs handled during YAML workflow execution?

Previous step outputs are handled by rendering them into the task text of subsequent steps. The orchestrator propagates context by combining input variables with prior results, storing per-step results in context for layered parallel or serial execution.

Do I need to install external dependencies to orchestrate agents in an AI session?

No, you do not need to install external dependencies to orchestrate agents. The workflow runner operates entirely within the current AI tool session, reading role prompts and executing YAML workflows using the built-in LLM without extra packages.

What limitations exist when running YAML workflows inside AI tools?

Limitations of running YAML workflows inside AI tools include reliance on the current session's LLM for execution capacity and context window size. Complex multi-role collaboration workflows are constrained by the session's token limits and the need for predefined agent directories.