Workflow Diagram Skill for Claude
Generates a Mermaid workflow diagram showing process steps, decisions, and state transitions. Use when documenting CI/CD pipelines or lifecycle processes.
Install
one command, takes just this skill from the repositorynpx skills add https://github.com/athola/claude-night-market --skill workflow-diagramThe instruction itself
9 sections, as written by the authorWorkflow Diagram
Generate a Mermaid flowchart showing process workflows,
pipelines, or state machines from code or documentation.
When To Use
- Visualizing CI/CD or deployment pipelines
- Documenting multi-step development workflows
- Mapping state machines or lifecycle processes
- Answering "what steps happen when X runs?"
When NOT To Use
- Data moving between components (use
cartograph:data-flow) - Component structure (use
cartograph:architecture-diagram)
Workflow
Step 1: Explore the Codebase
Dispatch the codebase explorer agent:
Agent(cartograph:codebase-explorer)
Prompt: Explore [scope] and return a structural model.
Focus on process steps, conditional logic, state
transitions, and pipeline stages for a workflow diagram.
Look for: Makefiles, CI configs, hook chains, command
sequences, and lifecycle methods.
Step 2: Generate Mermaid Syntax
Transform the structural model into a Mermaid flowchart
with decision nodes and process steps.
Rules for workflow diagrams:
- Use
flowchart TDfor sequential processes - Use
flowchart LRfor pipelines with parallel tracks - Use shapes to distinguish step types:
[Rectangle]for process steps{Diamond}for decision points([Stadium])for start/end states[[Subroutine]]for sub-processes((Circle))for join/sync points- Use
-->|label|for transition conditions - Group parallel tracks into subgraphs
- Color-code by outcome:
- Default for happy path
- Dotted (
-.->) for error/fallback paths - Thick (
==>) for critical path - Limit to 20 nodes maximum
Example output:
flowchart TD
start([Start: PR Created])
lint[Run Linters]
test[Run Tests]
review{Code Review}
approve[Approved]
changes[Request Changes]
merge([Merge to Main])
start --> lint --> test
test --> review
review -->|pass| approve --> merge
review -->|fail| changes -.-> lint
Step 3: Render via MCP
Call the Mermaid Chart MCP to render:
mcp__claude_ai_Mermaid_Chart__validate_and_render_mermaid_diagram
prompt: "Workflow diagram of [scope/process]"
mermaidCode: [generated syntax]
diagramType: "flowchart"
clientName: "claude-code"
If rendering fails, fix syntax and retry (max 2 retries).
Step 4: Present Results
Show the rendered diagram with a brief description of
the workflow stages and decision points (2-3 sentences).
Exit Criteria
- [ ] Mermaid
flowchartsyntax generated containing at least one
diamond {Decision} node representing a conditional branch
- [ ]
mcp__claude_ai_Mermaid_Chart__validate_and_render_mermaid_diagram
called and returns without error (or retry attempted and result
reported)
- [ ] Error/fallback paths rendered as dotted arrows (
-.->) distinct
from happy-path arrows when error paths exist in the source
- [ ] Node count is at most 20; if more steps exist, sub-processes
are collapsed into [[Subroutine]] nodes
- [ ] A 2-3 sentence description of workflow stages and decision
points is shown alongside the diagram
Other skills for the same job
different authors, same section of the catalogue
Workflow automation is the infrastructure that makes AI agents reliable. Without durable execution, a network hiccup during a 10-step payment flow means lost money and angry customers. With it, workflows resume exactly where they left off. This skill covers the platforms (n8n, Temporal, Inngest) and patterns (sequential, parallel, orchestrator-worker) that turn brittle scripts into production-grade automation. Key insight: The platforms make different tradeoffs. n8n optimizes for accessibility
Automate Cloudinary media management including folder organization, upload presets, asset lookup, transformations, and usage monitoring through natural language commands
You are a workflow automation expert specializing in creating efficient CI/CD pipelines, GitHub Actions workflows, and automated development processes. Design automation that reduces manual work, improves consistency, and accelerates delivery while maintaining quality and security.
Server management principles and decision-making. Process management, monitoring strategy, and scaling decisions. Teaches thinking, not commands.
Create a formal specification for an existing GitHub Actions CI/CD workflow, optimized for AI consumption and workflow maintenance.
Build and operate reproducible genomics workloads on DNAnexus with the dx CLI, dxpy, apps/applets, native workflows, dxCompiler, and Nextflow. Use for DNAnexus data transfers, dxapp.json development, execution monitoring, workflow import, and project automation.
Search across company knowledge bases (Confluence, Jira, internal docs) to find and explain internal concepts, processes, and technical details. When an agent needs to: (1) Find or search for information about systems, terminology, processes, deployment, authentication, infrastructure, architecture, or technical concepts, (2) Search internal documentation, knowledge base, company docs, or our docs, (3) Explain what something is, how it works, or look up information, or (4) Synthesize information from multiple sources. Searches in parallel and provides cited answers.
Production deployment principles and decision-making. Safe deployment workflows, rollback strategies, and verification. Teaches thinking, not scripts.
How to use it
Take athola/workflow-diagram from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.