UML and diagram generation via Kroki — class, sequence, activity, state, component, deployment, network, ER, C4, Mermaid, D2, Graphviz, BPMN, 27+ types.

Apache-2.0Auto-check passedDevelopment

Install Uml Diagram

skills CLI
$ npx skills add automateyournetwork/netclaw --skill uml-diagram -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install automateyournetwork/netclaw uml-diagram --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/automateyournetwork/netclaw.git skills-src && mkdir -p .claude/skills && cp -r skills-src/workspace/skills/uml-diagram .claude/skills/uml-diagram && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
uml-diagram
GitHub stars
676
Token cost
~3k tokens
SKILL.md length
728 words
Files
1
Skills in repo
120
Repo updated
First seen
Licence
Apache-2.0

At a glance

UML and diagram generation via Kroki — class, sequence, activity, state, component, deployment, network, ER, C4, Mermaid, D2, Graphviz, BPMN, 27+ types.

  • Works in 6 steps: Network Topology Documentation → Protocol State Machine Reference → Change Request Visualization → …
  • Generating a network diagram
  • SKILL.md covers MCP Server, Tools, Supported Diagram Types (27+) and Network Engineering Examples, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Uml Diagram is an agent skill from automateyournetwork/netclaw. UML and diagram generation via Kroki — class, sequence, activity, state, component, deployment, network, ER, C4, Mermaid, D2, Graphviz, BPMN, 27+ types. Use when generating a network diagram, creating a sequence diagram, drawing a rack layout, visualizing a protocol state machine, or producing architecture documentation.

Its SKILL.md is about 3k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Diagrams. It works with Mermaid. The repository describes itself as: An AI agent that claws through your network. The licence is Apache-2.0.

When your agent uses it

  • Generating a network diagram
  • Creating a sequence diagram
  • Drawing a rack layout
  • Visualizing a protocol state machine

Example prompts

  • “/uml-diagram”

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Network Topology Documentation
  2. Protocol State Machine Reference
  3. Change Request Visualization
  4. Data Center Rack Documentation
  5. Packet Format Reference
  6. Architecture Documentation

What it can do on your machine

Read from SKILL.md and the folder at commit aa90e7d. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Uml Diagram loads about 3k tokens when it runs. Until then it costs about 84 tokens; SKILL.md has 728 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~84
When it runs · the whole SKILL.md, loaded when a task matches
~3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from automateyournetwork/netclaw at commit aa90e7d, republished under its Apache-2.0 licence (© automateyournetwork). 728 words, ~3,017 tokens.

Download SKILL.mdSave it as .claude/skills/uml-diagram/SKILL.md (or your agent's skills folder).
name
uml-diagram
description
UML and diagram generation via Kroki — class, sequence, activity, state, component, deployment, network, ER, C4, Mermaid, D2, Graphviz, BPMN, 27+ types. Use when generating a network diagram, creating a sequence diagram, drawing a rack layout, visualizing a protocol state machine, or producing architecture documentation.
license
Apache-2.0
user-invocable
true

UML & Diagram Generation via Kroki

MCP Server

PropertyValue
Sourceantoinebou12/uml-mcp
Transportstdio (default) or HTTP
Tools2 (generate_uml, generate_diagram_url)
Resources8 (diagram types, templates, examples, formats, server info)
Prompts11 (class, sequence, activity, usecase, Mermaid, BPMN, etc.)
RenderingKroki (primary) with PlantUML and Mermaid.ink fallback

Tools

generate_uml

Generate a diagram and optionally save to disk.

ParameterTypeDefaultDescription
diagram_typestringrequiredDiagram type (class, sequence, mermaid, d2, graphviz, etc.)
codestringrequiredDiagram source code
output_dirstringnullDirectory to save file (null = no file write)
output_formatstring"svg"Output format: svg, png, pdf, jpeg, txt, base64
themestringnullPlantUML theme directive
scalefloat1.0SVG scaling factor (min 0.1)

Returns: { code, url, playground, local_path, content_base64, error }

generate_diagram_url

Get the Kroki rendering URL and optional base64 content without saving to disk.

ParameterTypeDefaultDescription
diagram_typestringrequiredDiagram type
codestringrequiredDiagram source code
output_formatstring"svg"Output format
themestringnullPlantUML theme
scalefloat1.0SVG scaling factor

Returns: { code, url, playground, content_base64, error }


Supported Diagram Types (27+)

PlantUML-based
TypeDescriptionUse Case
classClass diagramsObject relationships, inheritance, interfaces
sequenceSequence diagramsMessage flows between components
activityActivity diagramsWorkflow and process flows
usecaseUse case diagramsActor-system interactions
stateState machine diagramsFSM, protocol states
componentComponent diagramsSystem architecture
deploymentDeployment diagramsInfrastructure layout
objectObject diagramsInstance-level relationships
c4plantumlC4 architectureSystem context, container, component views
plantumlGeneric PlantUMLAny PlantUML syntax
Network & Infrastructure
TypeDescriptionUse Case
nwdiagNetwork diagramsNetwork topology, IP addressing, VLANs
rackdiagRack diagramsData center rack layouts
packetdiagPacket diagramsProtocol header formats (Ethernet, IP, TCP)
blockdiagBlock diagramsSystem block diagrams
actdiagActivity diagramsActivity flow (blockdiag family)
seqdiagSequence diagramsSequence flow (blockdiag family)
Other Backends
TypeDescriptionUse Case
mermaidMermaid diagramsFlowcharts, Gantt, sequence, pie, journey
d2D2 declarativeModern declarative diagrams
graphvizGraphviz DOTGraph layouts, dependency trees
erdEntity-RelationshipDatabase schema diagrams
dbmlDatabase MarkupDatabase schema (DBML syntax)
bpmnBPMN 2.0Business process modeling
structurizrStructurizr DSLC4 model architecture
ditaaASCII art to diagramConvert ASCII art to polished diagrams
wavedromDigital timingProtocol timing diagrams, signal waveforms
wirevizWire/cable harnessCable and connector documentation
bytefieldByte fieldBinary format documentation

Network Engineering Examples

Network Topology (nwdiag)
generate_uml(
  diagram_type="nwdiag",
  code="""
nwdiag {
  network dmz {
    address = "210.x.x.x/24"
    web01 [address = "210.x.x.1"];
    web02 [address = "210.x.x.2"];
  }
  network internal {
    address = "172.x.x.x/24"
    web01 [address = "172.x.x.1"];
    web02 [address = "172.x.x.2"];
    db01;
  }
}
""",
  output_format="svg"
)
Rack Diagram (rackdiag)
generate_uml(
  diagram_type="rackdiag",
  code="""
rackdiag {
  16U;
  1: UPS;
  2: UPS;
  3: Patch Panel;
  4: Catalyst 9300;
  5: Catalyst 9300;
  6: Nexus 9000;
  7: Nexus 9000;
  8: ASR 1001-X;
  9: ASR 1001-X;
  10: BIG-IP i5800;
  11: BIG-IP i5800;
  12: UCS C220;
  13: UCS C220;
  14: UCS C220;
  15: UCS C220;
  16: Cable Management;
}
""",
  output_format="png"
)
Packet Header (packetdiag)
generate_uml(
  diagram_type="packetdiag",
  code="""
packetdiag {
  colwidth = 32
  node_height = 72
  0-3: Version
  4-7: IHL
  8-15: DSCP / ECN
  16-31: Total Length
  32-47: Identification
  48-50: Flags
  51-63: Fragment Offset
  64-71: TTL
  72-79: Protocol
  80-95: Header Checksum
  96-127: Source Address
  128-159: Destination Address
}
""",
  output_format="svg"
)
BGP State Machine (state)
generate_uml(
  diagram_type="state",
  code="""
@startuml
[*] --> Idle
Idle --> Connect : Start
Connect --> OpenSent : TCP established
Connect --> Active : TCP failed
Active --> OpenSent : TCP established
Active --> Connect : ConnectRetry timer
OpenSent --> OpenConfirm : OPEN received (valid)
OpenSent --> Idle : OPEN received (error)
OpenConfirm --> Established : KEEPALIVE received
OpenConfirm --> Idle : Hold timer expired
Established --> Idle : NOTIFICATION / Hold expired
Established : Process UPDATE messages
@enduml
""",
  output_format="svg"
)
OSPF Area Design (class)
generate_uml(
  diagram_type="class",
  code="""
@startuml
package "Area 0 - Backbone" {
  class "Core-1" as C1 { router-id: 1.1.1.1 }
  class "Core-2" as C2 { router-id: 2.2.2.2 }
  C1 -- C2 : 10G P2P
}
package "Area 1 - Campus" {
  class "Dist-1" as D1 { router-id: 3.3.3.3 }
  class "Dist-2" as D2 { router-id: 4.4.4.4 }
}
package "Area 2 - DC" {
  class "Spine-1" as S1 { router-id: 5.5.5.5 }
  class "Spine-2" as S2 { router-id: 6.6.6.6 }
}
C1 -- D1 : ABR
C2 -- D2 : ABR
C1 -- S1 : ABR
C2 -- S2 : ABR
@enduml
""",
  output_format="svg"
)
Sequence: Change Request Flow
generate_uml(
  diagram_type="sequence",
  code="""
@startuml
actor Engineer
participant NetClaw
participant ServiceNow
participant Device
participant GAIT

Engineer -> NetClaw : "Add Loopback99"
NetClaw -> ServiceNow : Create Change Request
ServiceNow --> NetClaw : CR-12345 (New)
NetClaw -> ServiceNow : Wait for approval
ServiceNow --> NetClaw : CR-12345 (Implement)
NetClaw -> Device : Capture baseline
Device --> NetClaw : Running config
NetClaw -> Device : Apply config
Device --> NetClaw : Config applied
NetClaw -> Device : Verify change
Device --> NetClaw : Loopback99 up/up
NetClaw -> ServiceNow : Close CR-12345
NetClaw -> GAIT : Record full audit trail
NetClaw --> Engineer : Done. Verified.
@enduml
""",
  output_format="svg"
)
C4 Architecture (structurizr)
generate_uml(
  diagram_type="structurizr",
  code="""
workspace {
  model {
    engineer = person "Network Engineer"
    netclaw = softwareSystem "NetClaw" {
      openclaw = container "OpenClaw Agent"
      pyats = container "pyATS MCP"
      gait = container "GAIT MCP"
    }
    network = softwareSystem "Network Devices"
    servicenow = softwareSystem "ServiceNow"

    engineer -> openclaw "Chat"
    openclaw -> pyats "MCP (stdio)"
    openclaw -> gait "MCP (stdio)"
    pyats -> network "SSH/NETCONF"
    openclaw -> servicenow "REST API"
  }
  views {
    container netclaw {
      include *
      autoLayout
    }
  }
}
""",
  output_format="svg"
)

Workflows

1. Network Topology Documentation
pyats-topology → CDP/LLDP discovery data
→ generate_uml(type="nwdiag") → network topology diagram
→ msgraph-files → upload to SharePoint
→ GAIT
2. Protocol State Machine Reference
generate_uml(type="state") → BGP/OSPF/STP state machine
→ Share in Slack/Teams for team reference
→ GAIT
3. Change Request Visualization
servicenow-change-workflow → CR details
→ generate_uml(type="sequence") → change flow diagram
→ Attach to ServiceNow CR or GAIT log
→ GAIT
4. Data Center Rack Documentation
generate_uml(type="rackdiag") → rack layout
→ generate_uml(type="nwdiag") → network connections
→ Cross-reference with NetBox rack/device data
→ msgraph-files → upload to SharePoint
→ GAIT
5. Packet Format Reference
generate_uml(type="packetdiag") → protocol header diagram
→ rfc-lookup → verify against RFC
→ Share as reference material
→ GAIT
6. Architecture Documentation
generate_uml(type="structurizr" or "c4plantuml") → C4 architecture views
→ generate_uml(type="deployment") → deployment diagram
→ generate_uml(type="component") → component breakdown
→ msgraph-files → upload to SharePoint
→ GAIT

Show full SKILL.md (299 more words)Show less

Integration with Other Skills

SkillIntegration
pyats-topologyFeed CDP/LLDP discovery data into nwdiag for topology diagrams
drawio-diagramUML MCP for standards-based UML; Draw.io for freeform network diagrams
markmap-vizMarkmap for hierarchical mind maps; UML for structured diagrams
netbox-reconcileGenerate nwdiag diagrams color-coded by reconciliation status
rfc-lookupPair packetdiag with RFC references for protocol documentation
servicenow-change-workflowSequence diagrams documenting change request flows
msgraph-filesUpload generated diagrams to SharePoint
msgraph-teamsShare diagram URLs in Teams channels
gait-session-trackingRecord all diagram generation in GAIT

Comparison: UML MCP vs Draw.io vs Markmap

FeatureUML MCPDraw.ioMarkmap
Best forStructured UML, protocol diagrams, architectureFreeform network topologyHierarchical mind maps
Diagram types27+ (class, sequence, nwdiag, rack, packet, etc.)Network topology, flowchartsMind maps from markdown
RenderingKroki (server-side)Browser or CLIBrowser
OutputSVG, PNG, PDF, JPEG.drawio, PNG, SVG, PDFHTML
Code-basedYes (PlantUML, Mermaid, D2, DOT, etc.)XML/Mermaid/CSVMarkdown
Network-specificnwdiag, rackdiag, packetdiagFull topology editorOSPF/BGP hierarchies

When to use UML MCP:

  • Protocol state machines (BGP FSM, OSPF states, STP states)
  • Network topology diagrams from code (nwdiag)
  • Rack layouts (rackdiag)
  • Packet header documentation (packetdiag)
  • Sequence diagrams (change workflows, protocol exchanges)
  • Architecture documentation (C4, component, deployment)
  • Database schema diagrams (ERD, DBML)
  • Any diagram type supported by Kroki

When to use Draw.io:

  • Interactive topology editing
  • Native .drawio files for team collaboration
  • Color-coded reconciliation status overlays

When to use Markmap:

  • Hierarchical data (OSPF areas, BGP peers, config structure)
  • Quick visual summaries from markdown

Guardrails

  • All operations are read-only — generates diagrams, never modifies network state
  • Public Kroki by default — diagram source code is sent to kroki.io for rendering; use a local Kroki instance (KROKI_SERVER) for sensitive topology data
  • No secrets in diagrams — never include IP credentials, passwords, or SNMP communities in diagram source code
  • Record in GAIT — every diagram generation must be logged

© automateyournetwork, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in workspace/skills/uml-diagram of automateyournetwork/netclaw.

Open the folder on GitHubat commit aa90e7d

Compare with similar skills

Uml Diagram next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Uml Diagram compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Uml Diagram this skillautomateyournetwork/netclaw676—~3kAutomated safety check: PassApache-2.0
Archify Diagramstt-a1i/archify82k—~2.9kAutomated safety check: PassMIT
Diagram Designcathrynlavery/diagram-design49k1 repos~7.6kAutomated safety check: PassMIT
Draw.io Diagram StudioAgents365-ai/drawio-skill10k—~2.4kAutomated safety check: NotesMIT
Pretty Mermaid Rendererimxv/Pretty-mermaid-skills1.5k—~2kAutomated safety check: PassMIT
Archify Diagram BuilderUnclecheng-li/AI_Animation1.5k2 repos~4.1kAutomated safety check: PassMIT

Similar skills

  • Archify Diagrams

    tt-a1i/archify

    Creates interactive architecture, workflow, sequence, data-flow and lifecycle diagrams as standalone HTML with inline SVG, themes and image or video export.

    82k GitHub stars~2.9k tokensUpdated today
    DevelopmentAuto-check passed
  • Diagram Design

    cathrynlavery/diagram-design

    Creates branded diagrams, from architecture, flowchart and sequence to charts and maps, as self-contained HTML with inline SVG, with import from draw.io, Mermaid and Excalidraw.

    49k GitHub starsUsed in 1 repo~7.6k tokens
    DevelopmentAuto-check passed
  • Draw.io Diagram Studio

    Agents365-ai/drawio-skill

    Creates and edits editable draw.io diagrams from descriptions, code, infrastructure files, SQL and API schemas, with sync, review, test and export tools.

    10k GitHub stars~2.4k tokensUpdated today
    DevelopmentAuto-check: notes
  • Pretty Mermaid Renderer

    imxv/Pretty-mermaid-skills

    Writes and renders Mermaid diagrams as themed SVG, PNG or terminal ASCII and Unicode art with a bundled Node.js CLI that needs no browser.

    1.5k GitHub stars~2k tokensUpdated 1 mo ago
    DevelopmentAuto-check passed
  • Archify Diagram Builder

    Unclecheng-li/AI_Animation

    Builds validated architecture, workflow, sequence, data-flow and lifecycle diagrams as standalone interactive HTML from a small JSON spec, with optional motion and image export.

    1.5k GitHub starsUsed in 2 repos~4.1k tokens
    DevelopmentAuto-check passed
  • Mermaid

    WH-2099/mermaid-skill

    Generate Mermaid diagrams from user requirements. An agent skill from WH-2099/mermaid-skill.

    288 GitHub starsUsed in 4 repos~958 tokens
    DevelopmentAuto-check passed

More from automateyournetwork/netclaw

All 120 skills in this repo
  • EVE-NG Lab Topology Design

    automateyournetwork/netclaw

    Entry point for designing EVE-NG network labs: classifies the request, gathers missing requirements, proposes options and validates the resulting topology.

    677 GitHub stars~612 tokensUpdated today
    Auto-check passed
  • ACI Policy Change Deployment

    automateyournetwork/netclaw

    Deploys Cisco ACI policy changes only behind an approved ServiceNow Change Request, capturing pre and post-change fault baselines and rolling back automatically on a fault delta.

    677 GitHub stars~4.2k tokensUpdated today
    Auto-check passed
  • Cisco ACI Fabric Health Audit

    automateyournetwork/netclaw

    Runs a phased health audit of a Cisco ACI fabric through MCP tools: node status, links, tenant and policy review, faults and endpoint learning.

    677 GitHub stars~2.9k tokensUpdated today
    Auto-check passed
  • Anta Validation

    automateyournetwork/netclaw

    Validate Arista EOS network state against ANTA's pre-built 208-test catalogue, with structured pass/fail verdicts.

    677 GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Arista Cvp

    automateyournetwork/netclaw

    Arista CloudVision Portal (CVP) automation via REST API — device inventory, events, connectivity monitoring, tag management (4 tools).

    677 GitHub stars~2.2k tokensUpdated today
    Auto-check: notes
  • AWS Cloud Monitoring

    automateyournetwork/netclaw

    AWS CloudWatch monitoring — metrics, alarms, log queries, VPC flow log analysis, network performance.

    677 GitHub stars~1k tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Uml Diagram

What does Uml Diagram do?

UML and diagram generation via Kroki — class, sequence, activity, state, component, deployment, network, ER, C4, Mermaid, D2, Graphviz, BPMN, 27+ types. Uml Diagram is an agent skill from automateyournetwork/netclaw. UML and diagram generation via Kroki — class, sequence, activity, state, component, deployment, network, ER, C4, Mermaid, D2, Graphviz, BPMN, 27+ types.

When should I use Uml Diagram?

Uml Diagram fits situations like: generating a network diagram; creating a sequence diagram; drawing a rack layout; visualizing a protocol state machine.

How do I install Uml Diagram in Claude Code?

Run `npx skills add automateyournetwork/netclaw --skill uml-diagram -a claude-code`. Or copy the skill folder (workspace/skills/uml-diagram in automateyournetwork/netclaw) into .claude/skills/uml-diagram in your project. Claude Code loads it when a task matches its description.

How do I install Uml Diagram in Codex?

Run `npx skills add automateyournetwork/netclaw --skill uml-diagram -a codex`. Or copy the skill folder (workspace/skills/uml-diagram in automateyournetwork/netclaw) into .agents/skills/uml-diagram in your project. Codex loads it when a task matches its description.

Can I use Uml Diagram in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add automateyournetwork/netclaw --skill uml-diagram -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/uml-diagram, .gemini/skills/uml-diagram, .github/skills/uml-diagram and .opencode/skills/uml-diagram in your project.

What does Uml Diagram need to run?

SKILL.md names no scripts, command-line tools or credentials: Uml Diagram is instructions for the agent only.

Does Uml Diagram access the network?

SKILL.md names 1 domain. As links in the text: github.com. This is read from the text; nothing was executed.

Is Uml Diagram safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Uml Diagram use?

Uml Diagram is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Uml Diagram use?

About 3k tokens (SKILL.md is roughly 12k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Uml Diagram?

Skills that share tags, products or a category with Uml Diagram: Archify Diagrams (tt-a1i/archify, 82k stars), Diagram Design (cathrynlavery/diagram-design, 49k stars), Draw.io Diagram Studio (Agents365-ai/drawio-skill, 10k stars) and Pretty Mermaid Renderer (imxv/Pretty-mermaid-skills, 1.5k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Uml Diagram?

automateyournetwork (a GitHub user) maintains it in automateyournetwork/netclaw, which has 676 GitHub stars. The repository holds 120 skills in this directory. The repository was last updated on October 9, 2026.

Source: automateyournetwork/netclaw on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.