af-workflow-builder

Create, update, validate, and debug Agentic Forge YAML workflows.

1|Updated Nov 12, 2025
One-click install
npx skills add https://github.com/e-stpierre/agentic-forge --skill af-workflow-builder
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: af-workflow-builder
Source: https://github.com/e-stpierre/agentic-forge/tree/main/src/authoring/.claude/skills/workflow-builder
Command: npx skills add https://github.com/e-stpierre/agentic-forge --skill af-workflow-builder

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill removes the complexity of authoring, updating, validating, and debugging Agentic Forge YAML workflows by applying complete schema knowledge and workflow best practices so you can produce reliable automation definitions quickly.

Core Features & Use Cases

  • Create: Generate complete, schema-valid workflows from high-level descriptions with sensible defaults and variable definitions.
  • Update & Preserve: Read and modify existing workflow YAML while preserving structure and comments.
  • Explain & Validate: Provide authoritative explanations of workflow properties, detect schema errors, and produce actionable validation reports.
  • Debug: Diagnose execution issues (undefined variables, conditions, ralph-loop completion, worktree or runtime mismatches) and suggest precise YAML fixes.
  • Use Case: Developer teams writing CI-style agentic pipelines can author plan-build-review workflows, add parallel analyses, or fix conditional branches with confidence.

Quick Start

Create a workflow that plans, implements, and reviews the feature Add user authentication.

Frequently Asked Questions about af-workflow-builder

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

FAQPage Schema
How do I create a multi-step YAML workflow for coding agent orchestration?

To create a multi-step YAML workflow for coding agent orchestration, provide a high-level description of your desired pipeline. The skill generates complete, schema-valid YAML with sensible defaults, variable definitions, and the required prompt, serial, parallel, or conditional steps.

What is the best way to debug an Agentic Forge workflow with undefined variables?

The best way to debug an Agentic Forge workflow with undefined variables is to use a validation tool that diagnoses execution issues. It detects variable mismatches and condition errors, then provides precise YAML fixes and execution debugging guidance to resolve the problem.

Can I update an existing YAML workflow without losing my comments and structure?

Yes, you can update an existing YAML workflow without losing your comments and structure. The skill reads and modifies existing workflow YAML while preserving the original formatting, ensuring your multi-step agent orchestration definitions remain intact during maintenance.

How do I validate schema conformance for complex agentic pipelines?

To validate schema conformance for complex agentic pipelines, run your YAML workflow through a validation process. This detects schema errors, checks worktree and runtime constraints, and produces an actionable validation report with suggested YAML edits.

Why does my ralph-loop workflow step fail to complete during execution?

A ralph-loop workflow step fails to complete during execution due to condition mismatches or undefined variables. Debugging the workflow diagnoses these specific execution issues, checks runtime constraints, and suggests precise YAML fixes to ensure the loop finishes correctly.

Does this workflow authoring tool support wait-for-human steps?

Yes, this workflow authoring tool supports wait-for-human steps. It handles authoring and maintenance for multi-step coding agent orchestration, applying schema validation to conditional, parallel, and wait-for-human steps to ensure reliable automation definitions.