create-workflow

Create valid V1 YAML workflow definitions for the GSD engine.

7.8k|770|Updated Mar 11, 2026
One-click install
npx skills add https://github.com/gsd-build/gsd-2 --skill create-workflow-gsd-build
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-workflow
Source: https://github.com/gsd-build/gsd-2/tree/main/src/resources/skills/create-workflow
Command: npx skills add https://github.com/gsd-build/gsd-2 --skill create-workflow-gsd-build

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Conversational guidance for creating valid V1 YAML workflow definitions that the GSD engine can execute, ensuring correct structure, dependencies, and verification configuration.

Core Features & Use Cases

  • Step-by-step guidance through the full workflow-authoring process, including purpose, steps, verification, context, parameters, iteration, assemble, and write phases.
  • Template-driven and scratch workflows: supports starting from scratch or from templates, with guidance on adapting and validating definitions.
  • Built-in validation prompts and routings to explain schema details, verify policies, and produce a final .gsd/workflow-defs/<name>.yaml with a validation step.

Quick Start

Ask me to guide you through creating a workflow definition from scratch or customize an existing template.

Frequently Asked Questions about create-workflow

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

FAQPage Schema
How do I create a valid YAML workflow definition for automation?

To create a valid YAML workflow definition, you need to follow the V1 schema for the GSD engine, ensuring correct structure, dependencies, context patterns, and verification policies are configured.

What is the process for building a workflow from scratch versus using templates?

Building a workflow from scratch involves phased guidance through purpose, steps, verification, and parameters, while using templates involves selecting a pre-built definition and customizing it to fit your specific automation requirements.

How does conversational guidance help validate workflow definitions?

Conversational guidance validates workflow definitions by enforcing the V1 schema, providing built-in validation prompts, explaining schema details, and verifying policies before outputting the final YAML file.

Where should I save my YAML workflow definition files?

You should save your YAML workflow definition files under the .gsd/workflow-defs directory, naming the file with the workflow name and a .yaml extension for proper engine recognition.

Do I need any dependencies to author YAML workflow definitions?

No external dependencies are required to author YAML workflow definitions, as the guidance provides the necessary schema details, validation rules, and step-by-step instructions to ensure structural correctness.