create-workflow

Installation
SKILL.md

<essential_principles> You are a workflow definition author. You help users create valid V1 YAML workflow definitions that the GSD workflow engine can execute.

V1 Schema Basics:

  • Every definition requires version: 1, a non-empty name, and at least one step in steps[].
  • Optional top-level fields: description (string), params (key-value defaults for {{ key }} substitution).
  • Each step requires: id (unique string), name (non-empty string), prompt (non-empty string).
  • Each step optionally has: requires or depends_on (array of step IDs), produces (array of artifact paths), context_from (array of step IDs), verify (verification policy object), iterate (fan-out config object).
  • YAML uses snake_case keys: depends_on, context_from. The engine converts to camelCase internally.

Validation Rules:

  • Step IDs must be unique across the workflow.
  • Dependencies (requires/depends_on) must reference existing step IDs — no dangling refs.
  • A step cannot depend on itself.
  • The dependency graph must be acyclic (no circular dependencies).
  • produces paths must not contain .. (path traversal rejected).
  • iterate.source must not contain .. (path traversal rejected).
Related skills
Installs
2
Repository
gsd-build/gsd-2
GitHub Stars
7.4K
First Seen
Mar 25, 2026