pipeline-runner

Dispatch named taffy workflows, local skills, or agents with registry fallback.

23|7|Updated Feb 14, 2026
One-click install
npx skills add https://github.com/kinncj/MAPLE --skill pipeline-runner-kinncj
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pipeline-runner
Source: https://github.com/kinncj/MAPLE/tree/main/template/.opencode/skills/pipeline-runner
Command: npx skills add https://github.com/kinncj/MAPLE --skill pipeline-runner-kinncj

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Orchestrates the dispatch of a named taffy workflow, a local skill, or a sub-agent, with registry fallback when not found locally, and reports progress to the Maple UI.

Core Features & Use Cases

  • Dispatch a taffy workflow by name from .opencode/taffy/<name>.yaml.
  • Invoke a local skill located at .opencode/skills/<name>/.
  • Delegate to an agent via .opencode/agents/<name>.md when needed.
  • Falls back to the skills.sh registry if a target is not available locally.
  • Tracks all runs in .claude/state/maple.json so the Maple TUI can show live progress.

Quick Start

Invoke the pipeline-runner with a target name to dispatch a workflow, skill, or agent.

Frequently Asked Questions about pipeline-runner

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

FAQPage Schema
How do I dispatch a taffy workflow by name?

To dispatch a taffy workflow, invoke the pipeline-runner with the target name. It locates the workflow definition in .opencode/taffy/<name>.yaml, executes it, and reports live progress to the Maple UI while persisting state.

What happens when a local skill or workflow is not found during dispatch?

When a local target is not found, the dispatch process falls back to the skills.sh registry. This ensures the named workflow, skill, or agent is still executed and tracked in the .claude/state/maple.json state file.

How does agent dispatch work with local skills?

Agent dispatch follows a resolution order of taffy workflow, local skill, and then agent. If a local skill is unavailable, it delegates to an agent via .opencode/agents/<name>.md to complete the task.

How do I track live progress for dispatched workflows?

Live progress for dispatched workflows is tracked by persisting run state in .claude/state/maple.json. This allows the Maple TUI to read the file and display real-time execution updates for the workflow or agent.

Does pipeline-runner handle missing targets or dispatch failures?

Yes, the dispatch mechanism handles missing targets and execution failures. It provides clear messaging when a target cannot be resolved across the taffy, local skill, agent, or registry fallback chain.