workflow-diagram
Generates a Mermaid workflow diagram showing process steps, decisions, and state transitions. Use when documenting CI/CD pipelines or lifecycle processes.
How do I install this agent skill?
npx skills add https://github.com/athola/claude-night-market --skill workflow-diagramIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill generates Mermaid workflow diagrams by exploring codebases and rendering them via a well-known diagramming service. No security issues were detected.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
Workflow 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_diagramcalled 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
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/athola/claude-night-market/workflow-diagram">View workflow-diagram on skillZs</a>