workflow-markdown

Execute markdown-based workflows with YAML frontmatter and shell, JavaScript, or Python code blocks.

1|Updated Feb 25, 2026
One-click install
npx skills add https://github.com/winsorllc/upgraded-carnival --skill workflow-markdown
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: workflow-markdown
Source: https://github.com/winsorllc/upgraded-carnival/tree/main/.pi/skills/workflow-markdown
Command: npx skills add https://github.com/winsorllc/upgraded-carnival --skill workflow-markdown

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill streamlines complex agent tasks by allowing them to be defined, documented, and executed directly from human-readable markdown files, bridging the gap between documentation and execution.

Core Features & Use Cases

  • Literate Workflows: Define multi-step processes in markdown, combining documentation with executable code blocks (shell, JavaScript, Python).
  • Context Awareness: Maintain context across workflow steps, enabling sequential task execution.
  • Use Case: Automate a software deployment process by defining steps like "build project," "run tests," and "deploy to staging" within a single markdown file, which the agent can then execute.

Quick Start

Use the workflow_run tool to execute the 'Update Dependencies' workflow.

Frequently Asked Questions about workflow-markdown

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

FAQPage Schema
How do I execute markdown-based agent workflows with code blocks?

You can execute markdown-based agent workflows by parsing YAML frontmatter and executable code blocks. This allows deterministic task execution by combining documentation and executable code in a single human-readable markdown file.

Can I run shell, JavaScript, and Python code blocks within a single markdown workflow file?

Yes, markdown workflow execution supports shell, JavaScript, and Python code blocks. It maintains context awareness across these steps, enabling sequential task execution with variable substitution throughout the workflow.

What is literate programming for task orchestration and when do I need it?

Literate programming for task orchestration defines multi-step processes in markdown, combining documentation with executable code. You need it when streamlining complex agent tasks that require both human-readable documentation and deterministic execution.

Does markdown workflow execution support context awareness between sequential steps?

Yes, markdown workflow execution maintains context awareness across workflow steps. This enables sequential task execution where variables and state are substituted and passed between shell, JavaScript, and Python code blocks.

How do I automate a multi-step software deployment process using markdown files?

You can automate software deployment by defining steps like build, test, and deploy as executable code blocks within a single markdown file. The agent parses the YAML frontmatter and executes each step sequentially with full context awareness.

What are the limitations of using markdown files for task orchestration?

Markdown-based task orchestration requires code blocks to be written in shell, JavaScript, or Python. Complex workflows depend on YAML frontmatter parsing and variable substitution, meaning syntax errors in the markdown will disrupt deterministic execution.