Creating Workflows

What problem does it solve?

Documenting multi-step processes often results in static, unexecutable guides. This Skill provides the methodology to design and write markdown-based workflows that are both human-readable documentation and executable processes, ensuring consistency, automation, and reducing manual effort.

Core Features & Use Cases

• Markdown-Based Syntax: Uses conventional markdown (headers, code blocks, Pass/Fail labels) for steps, commands, conditionals, and prompts.
• Executable Documentation: Ensures workflows can be run by a tool, providing a single source of truth for process and execution.
• Enforcement & Guided Modes: Supports designing workflows for strict algorithmic compliance or flexible guidance, adapting to various needs.
• Use Case: To standardize your team's git commit process, use this Skill to create a markdown workflow that includes pre-commit checks, atomic commit verification, and conventional message formatting, ensuring every commit adheres to standards automatically.

Quick Start

To create a new workflow file (e.g., my-workflow.md):

Start with H1 headers for steps:

# Step 1: Description of what this step does

Add bash commands in code blocks:

```bash

mise run test

```

Use Pass/Fail for conditionals:

Fail: STOP (fix tests)

Add prompts for human input:

Prompt: Is the documentation complete and accurate?