Author and operate durable multi-step agent workflows in the Pi coding agent.
npx skills add https://github.com/osolmaz/pi-workflows --skill pi-workflows-osolmaz
Please help me install this Agent Skill. Skill: pi-workflows Source: https://github.com/osolmaz/pi-workflows/tree/main/skills/pi-workflows Command: npx skills add https://github.com/osolmaz/pi-workflows --skill pi-workflows-osolmaz
workflow tool with exact request IDs and revisions. - Step Completion Contracts: Complete submitted agent steps with validated structured output or finish assistant-message steps through normal visible replies. - Workflow Authoring: Compose .workflow.ts graphs from node and edge primitives with checkpoints, human decisions, timeouts, bounded loops, and nested workflow mounts. - Use Case: You need an implementation task to run through plan, implement, verify, and review stages with a human approval gate; define the graph in a .workflow.ts file, start it with structured input, and let the engine handle routing, retries, and recovery. ## Quick Start Ask the agent to list available workflows and start one with the required structured input for your task.High-intent search queries and answers about installing and using this skill.
Call the workflow tool with action "start", the workflow name or .workflow.ts file path, and complete structured input. Make one start call per requested run, then end your turn because the first step arrives as a new model turn.
Create a .workflow.ts module whose default export comes from defineWorkflow, composing existing node and edge primitives. Keep compute pure, put side effects in agent or action nodes, set explicit timeouts, and bound loops with maxSteps.
Yes, the Skill requires the pi-workflows extension installed in the Pi coding agent, via npm:@osolmaz/pi-workflows or the GitHub source. The extension provides the workflow tool and runtime engine the Skill operates.
Submissions fail when the output does not match the expected shape in the current step contract or when the requestId is wrong. Each attempt issues a new requestId, so never reuse one from an earlier attempt; correct the output and resubmit to the same request.
Use a workflow for durable multi-step work needing explicit routing, retries, checkpoints, scheduled waits, or progress tracking. Keep simple one-turn tasks outside a workflow, and use a controller rather than a workflow for indefinite resource reconciliation.
cshyangBuild and manage pi-coding-agent extensions with TypeScript and the ExtensionAPI.
TrollHeapRun pre-commit hooks and golangci-lint on modified Go files.
hardisgroupcomBuild, lint, and test code changes with yarn commands.
lucking7Execute tasks directly without persona-based sub-agent dependencies.