create-workflow

Author valid V1 YAML workflow definitions for OTTO with schema constraints.

Updated May 25, 2026
One-click install
npx skills add https://github.com/cmetech/otto-cli --skill create-workflow-cmetech
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-workflow
Source: https://github.com/cmetech/otto-cli/tree/main/src/resources/skills/create-workflow
Command: npx skills add https://github.com/cmetech/otto-cli --skill create-workflow-cmetech

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

OTTO workflow authors often struggle to produce valid YAML workflow definitions that integrate with the engine's V1 schema. This skill guides users through purpose, steps, verification, and context patterns to produce correct definitions.

Core Features & Use Cases

  • Interactive guidance for crafting from scratch or templates.
  • Enforces schema constraints: unique step IDs, acyclicity, valid dependencies, safe path handling, and proper parameter substitution.
  • Demonstrates and documents common patterns like context_from, iterate, and params with examples for real-world workflows.

Quick Start

Ask OTTO to guide you through building a new workflow definition from scratch.

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 OTTO?

To create a valid YAML workflow definition for OTTO, you need an interactive guide that enforces the V1 schema, ensuring unique step IDs, acyclic graphs, and proper parameter substitution. This skill provides conversational guidance to build workflows from scratch or templates while applying the engine's rules.

What are the constraints for OTTO workflow parameters and paths?

OTTO workflow constraints include unique step IDs, acyclic dependency graphs, safe path handling for produces and iterate, and correct parameter substitution. The workflow validation enforces these rules to ensure your YAML definition integrates correctly with the V1 engine schema.

How do I use iterate and context_from in YAML workflow definitions?

Iterate and context_from are common patterns in YAML workflow definitions used for parameterized execution and data passing. The skill demonstrates these patterns with real-world examples, showing how to properly handle iteration paths and context substitution within your workflow steps.

Can I build OTTO workflows from existing templates instead of starting from scratch?

Yes, you can build OTTO workflows from templates or from scratch. The skill provides interactive guidance for both approaches, helping you apply the engine's rules to template-based definitions while ensuring proper verification, parameter handling, and output location guidance.

Why does my OTTO workflow YAML fail validation due to cyclic dependencies?

OTTO workflow YAML fails validation when step dependencies form cycles, violating the acyclic graph constraint. The skill enforces acyclicity during workflow creation, guiding you to structure step IDs and dependencies so they never create circular references in the execution graph.