antoinebou12/uml-diagrams
plugins/uml-mcp/skills/uml-diagrams/SKILL.md
Create and validate diagrams with the uml-mcp MCP server (generate_uml, validate_uml, list_diagram_types, generate_uml_batch). Use for UML, Mermaid, D2, Graphviz, Kroki URLs, or diagram_type questions.
$ install --global
skillsauthnpx skillsauth add antoinebou12/uml-mcp uml-diagramsInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 26, 2026, 3:40 AM118.1s1 file scanned
SKILL.md
- name:
- uml-diagrams
- description:
- >-
Maintainers: Canonical long-form copy also lives in
.skill/skills/uml-mcp-diagrams/SKILL.md. Keep tool tables andoutput_dirwording aligned with the Smithery bundle uml-skill.
UML-MCP in Claude Code
Goal
Produce valid diagram_type and DSL code, call generate_uml, and give the user the url (and playground when present). Prefer URL-first output: omit output_dir / use null unless the user wants files on disk (local stdio only).
Do
- If
diagram_typeis unclear, uselist_diagram_typesor readuml://types/uml://formatsbefore generate_uml. - Match
diagram_typeto the language ofcode(e.g. Mermaid body →mermaid;@startuml→plantumlor the specific Kroki PlantUML subtype when applicable). - Use
validate_umlbefore heavy retry loops or on pasted diagram source. - Return the
urlplus a short copy ofcodeso the user can edit and regenerate.
Do not
- Invent
diagram_typeoroutput_format; confirm fromuml://types/uml://formatsorlist_diagram_types. - Put prose inside
code—only valid diagram DSL. - Set
output_dirunless the user asked for saved files (not applicable to the default HTTP deployment).
Before generating
- Read
uml://types/uml://capabilitieswhen the type is ambiguous. - Use
uml://templates,uml://examples, oruml://recipesfor starters. - Optional:
validate_umlwithstrict: truefor stricter Mermaid/D2 checks.
Tools and resources
- Tools:
generate_uml,validate_uml,list_diagram_types,generate_uml_batch - Resources:
uml://types,uml://formats,uml://templates,uml://examples,uml://capabilities,uml://recipes,uml://server-info,uml://workflow, plus URIs fromresources/list
Prompts (when exposed): uml_diagram, uml_diagram_with_thinking, class_diagram, sequence_diagram, activity_diagram, usecase_diagram, mermaid_sequence_api, mermaid_gantt, bpmn_process_guide, c4_model, wireviz_harness, bpmn_executable_process, convert_class_to_mermaid, algorithm_explainer, paper_concept_diagram.
generate_uml inputs
| Field | Notes |
| --- | --- |
| diagram_type | Required; must match server-supported keys. |
| code | Required; DSL only. |
| output_dir | Omit for HTTP MCP (URL + base64 in response). |
| output_format | Often svg; check uml://formats for the type. |
| theme | PlantUML types only. |
| scale | SVG only. |
After generation
Highlight url, then playground if present, then local_path only when output_dir was used. On error, fix DSL or types and retry or run validate_uml.
Intent → type hints
| Intent | Typical diagram_type |
| --- | --- |
| Classes / associations | class or Mermaid classDiagram |
| Lifelines / messages | sequence or Mermaid sequence |
| Flow / BPMN | activity, bpmn, or Mermaid flowchart |
| Quick charts | mermaid |
| Declarative layout | d2 |
When several fit, prefer what the user named; otherwise prefer the clearest match from uml://types.
Related Skills
antoinebou12/uml-mcp-diagrams
tools
VerifiedTrustedCommunity
Creates diagrams via the uml-mcp MCP server (generate_uml, validate_uml, list_diagram_types, generate_uml_batch) and returns shareable Kroki URLs plus optional playground links. Use when the user wants a diagram, asks for PlantUML/Mermaid/D2/UML, wants a URL instead of a saved file, or mentions uml-mcp, Kroki, or diagram_type.
79SKILL.mdUpdated Apr 15, 2026
antoinebou12/uml-diagramming
tools
VerifiedTrustedCommunity
Produces Mermaid or PlantUML diagram code from user specifications for UML, architecture, and flow diagrams. Use when the user asks for a diagram (sequence, class, activity, use case, component, state, deployment), diagram code, or when generating diagram script for documentation, design, or the generate_uml MCP tool. Supports Kroki-renderable output.
79SKILL.mdUpdated Apr 4, 2026
antoinebou12/modern-python
tools
VerifiedTrustedCommunity
Modern Python tooling and best practices using uv, ruff, ty, and pytest. Covers project setup with pyproject.toml (PEP 735), src layout, linting/formatting with ruff, type checking with ty, testing with pytest and coverage, pre-commit with prek, and security (pip-audit, detect-secrets, actionlint). Use when setting up or working on Python projects, replacing pip/virtualenv with uv, replacing flake8/black/mypy with ruff/ty, adding pre-commit or security scanning, or when the user mentions uv, ruff, ty, pytest, or cookiecutter-python patterns.
79SKILL.mdUpdated Apr 4, 2026
antoinebou12/mcp-python
tools
VerifiedTrustedCommunity
Create and extend MCP (Model Context Protocol) servers in Python using FastMCP and the official SDK. Covers tools, resources, prompts, STDIO vs HTTP transports, logging rules for STDIO, and production best practices. Use when building or modifying MCP servers in Python, adding tools/resources/prompts, debugging MCP servers, or choosing transport and client config.
79SKILL.mdUpdated Apr 4, 2026