skills.rest
gozonerd
gozonerdCOMMUNITY
Explore all skills by this author →
GitHub

diagram-pack

Routes format-ambiguous diagram requests to the appropriate diagram-orchestration skill.

Updated Apr 11, 2026
Search Tags:#routing#mermaid#visualization#diagram#plantuml#graphviz#bpmn
One-click install
npx skills add https://github.com/gozonerd/shadow-ai-assessment --skill diagram-pack-gozonerd
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: diagram-pack
Source: https://github.com/gozonerd/shadow-ai-assessment/tree/main/.claude/skills/diagram-pack
Command: npx skills add https://github.com/gozonerd/shadow-ai-assessment --skill diagram-pack-gozonerd

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When you ask for a diagram without specifying a format, picking the wrong tool wastes effort — Mermaid can't be machine-validated, Graphviz is overkill for five nodes, and BPMN is unnecessary for a README flowchart. This Skill encodes the selection logic so you get routed to the right format-specific skill automatically. ## Core Features & Use Cases - Format routing: Asks 2-4 targeted questions (consumer type, consumption context, structure, scale) and routes to one of five sibling skills: mermaid, graphviz, plantuml, bpmn, or html-interactive. - Gate-path handling: Distinguishes human-reader artifacts from deterministic-validator artifacts (CI schema checks, linted intake gates), routing gate-consumed work only to schema-bearing formats like BPMN 2.0 XML or Graphviz DOT — never Mermaid. - Gap documentation: Flags documented gaps such as threat-model DFDs (OWASP Threat Dragon JSON / pytm) that no sibling skill currently produces. - Use Case: You say "diagram this pipeline" without naming a format; the Skill asks where it will be consumed and how large it is, confirms "Routing to /mermaid-ai-orchestration because it ships inline in your README," then invokes that sibling skill. ## Quick Start Ask the assistant to diagram your workflow or system without naming a format, and answer the short routing questions to get the right diagram type.

Frequently Asked Questions about diagram-pack

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

FAQPage Schema
How do I choose between Mermaid, Graphviz, and PlantUML for a diagram?▼

Choose based on consumption context, structure, and scale. Mermaid fits small diagrams (under ~15 nodes) embedded in markdown or GitHub; Graphviz handles dense dependency graphs of 20+ nodes and publication-quality output; PlantUML suits rich swimlanes and formal UML sequence or state diagrams.

What diagram format should I use for a machine-validated CI gate?▼

Use a schema-bearing format: BPMN 2.0 XML for process models with gateway-lane-event semantics, or Graphviz DOT for dependency DAGs parseable via dot -Tdot_json. Never use Mermaid for gate-consumed artifacts — it has no machine-readable AST export for flowcharts.

Can Mermaid diagrams be validated by a deterministic linting gate?▼

No. Mermaid offers no machine-readable AST export for flowcharts (open issue mermaid-js/mermaid-cli#978), so a deterministic validator cannot parse or lint it. Gate-consumed artifacts must use formats with published schemas such as BPMN 2.0 XML or Graphviz DOT.

When should I use BPMN instead of a Mermaid flowchart?▼

Use BPMN when modeling business processes with formal gateway, lane, event, and message-flow semantics, or for compliance and regulatory reviews where auditors recognize the notation. Mermaid is better for lightweight inline flowcharts in documentation.

What tool should I use for a threat-model DFD consumed by a governance gate?▼

Use a schema-carrying threat-model format such as OWASP Threat Dragon JSON or pytm (threat model as Python code with trust boundaries and a Classification enum). None of the five sibling diagram skills produce these formats, so this is a documented gap handled directly in-thread.

When should I bypass the diagram routing skill entirely?▼

Bypass routing whenever you already know the format — for example, asking for a Mermaid diagram directly invokes the mermaid skill. The router only adds value when the format is ambiguous or you need help choosing.

Related Skills

Explore More Software Engineering Skills→
PedroGiudicePedroGiudice
5

architecture-diagram-creator

Generate HTML architecture diagrams with data flows and deployment layers.

Community
Advanced
M-Abdullah07M-Abdullah07
1

mermaid-graph-renderer

Convert Mermaid diagram syntax into SVG, PNG, or PDF images.

Community
Intermediate
WellApp-aiWellApp-ai
341

bpmn-workflow

Generate BPMN 2.0 diagrams from feature specifications and link them to Gherkin scenarios.

Official
Advanced
AAbdulghanyAAbdulghany

threat-model

Generate a STRIDE threat catalogue from a DFD snapshot and export Threat Dragon v2 JSON.

Community
Advanced