workflow-authoring

Creates and validates DAG workflow definitions for Pi coding agents using structured markdown schemas.

Updated Jun 18, 2026
One-click install
npx skills add https://github.com/MinhDuyDEV/mdpi --skill workflow-authoring-minhduydev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: workflow-authoring
Source: https://github.com/MinhDuyDEV/mdpi/tree/main/.pi/skills/workflow-authoring
Command: npx skills add https://github.com/MinhDuyDEV/mdpi --skill workflow-authoring-minhduydev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps create and maintain valid DAG workflows for Pi coding agents, preventing malformed phase structures, placeholder issues, and execution failures.

Core Features & Use Cases

  • Workflow Schema Design: Defines the required markdown structure, phases, dependencies, concurrency rules, and synthesis sections for executable workflows.
  • Execution-Aware Authoring: Guides creation of prompts, fan-out patterns, placeholders, and runner-compatible workflow definitions.
  • Use Case: Create or debug a multi-agent workflow that coordinates planning, implementation, review, and final synthesis while passing validation checks.

Quick Start

Use the workflow-authoring skill to create a valid.pi/workflows markdown workflow for a multi-agent development process.

Frequently Asked Questions about workflow-authoring

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

FAQPage Schema
How do I create a valid DAG workflow for a Pi coding agent?

To create a DAG workflow for a Pi coding agent, you must structure a markdown file with defined phases, dependencies, concurrency rules, and synthesis sections that pass lint validation checks.

What is a multi-agent workflow and how does fan-out execution work?

A multi-agent workflow coordinates planning, implementation, review, and final synthesis. Fan-out execution enables concurrent agent operations by applying structured markdown schemas and placeholder conventions to orchestrate tasks.

Why does my agent workflow fail validation due to malformed phase structures?

Agent workflow validation fails when phase structures are malformed or placeholders are misconfigured. To prevent execution failures, you must apply formatting rules and lint constraints to ensure executable agent orchestration files.

How do I debug a broken multi-agent workflow that won't execute properly?

To debug a broken multi-agent workflow, you must validate the markdown schema against lint constraints, checking for malformed phase structures, dependency issues, and incorrect placeholder conventions that cause execution failures.

Can I use structured markdown to define agent orchestration tasks with concurrency?

Yes, structured markdown defines executable agent orchestration tasks with concurrency. By using specific schemas, you can establish phases, dependencies, and synthesis requirements to coordinate concurrent multi-agent execution.