skilld
All skills
agents365-ai avatar

/plantuml-skill

@72ee04b
by Agents365.aiagents365-ai/365-skills57 stars
12

Use when user requests diagrams, flowcharts, sequence diagrams, class diagrams, component diagrams, ER diagrams, architecture charts, or visualizations — including generating a diagram from existing source code, or rendering/extracting PlantUML embedded in a Markdown file to images (e.g. preparing docs for Confluence/Notion). Also use proactively when explaining systems with 3+ components, APIs, data flows, or class hierarchies. Generates .puml files and exports to PNG/SVG via Kroki API (no local install required).

Ask your Agent

Use this Skill: https://skilld.dev/gh/agents365-ai/365-skills/plantuml-skill

This session only. Nothing lands on disk.

referencesrendering-backends.md

≈481 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Rendering Backends — Selection, Precedence & Transparency

The skill can render through three backends. They produce the same output; they differ in install cost and, crucially, where your source goes.

Backend Endpoint / command Install Source leaves your machine?
Public Kroki (default) https://kroki.io/plantuml/{png,svg} just curl Yes — POSTed to a third-party service
Local Kroki (Docker) http://localhost:8000/plantuml/{png,svg} docker run -d -p 8000:8000 yuzutech/kroki No
Local plantuml.jar java -jar plantuml.jar diagram.puml Java + Graphviz + jar No

Selection / precedence

Decide the backend before Step 4:

  1. Honor an explicit choice — if the user named a backend, or KROKI_URL is set in the environment, use it. (Swap https://kroki.io → that base URL in the Step 4 commands.)
  2. Sensitive content — internal systems, secrets, proprietary names, unreleased architecture → prefer a local backend. If none is available, say so and ask before sending the source to public Kroki.
  3. Otherwise → default to public Kroki (zero-install).

Use one base URL throughout a session; don't mix.

No silent downgrade

This is the rule that makes the choice trustworthy:

  • Don't quietly fall back. If the chosen backend is unavailable (local Kroki not running, no java/jar), do not silently switch to another. Tell the user which backend failed and what the alternatives are, then proceed only with a sensible default or their go-ahead.
  • Report the path in Step 8. State which backend rendered and whether the source left the machine — e.g. "rendered via public Kroki (source uploaded to kroki.io)" vs "rendered via local Kroki (stayed on your machine)." The user should never have to guess whether their diagram crossed the network.

Source: SKILL.md on GitHub

Third-party checks

1 warningtoday3 checks · Risk SAFE
  • Gen Agent Trust Hubtoday

    The skill is safe for general use. It facilitates diagram generation by sending PlantUML source text to the public Kroki API for rendering. Users should be aware that diagram content is transmitted externally to kroki.io, although the documentation provides options for local rendering of sensitive data. There is a minor risk of indirect prompt injection when the skill processes external source code or markdown files to extract diagrams.

  • Sockettoday

    No alerts

  • Snyktoday

    Risk: MEDIUM · 1 issue

Provenance

Signed by skilld at 72ee04b. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 11 hours ago.

Activeupdated 3 weeks ago

Capability

homepage
https://github.com/Agents365-ai/365-skills
platforms
[
  "macos",
  "linux",
  "windows"
]
Other metadata
compatibility
Requires curl on PATH (pre-installed on macOS/Linux/Windows Git Bash). Default renderer is the public Kroki API at https://kroki.io; can also point to a local Kroki Docker instance, or fall back to a local PlantUML jar + Java + Graphviz.
metadata
{
  "openclaw": {
    "requires": {
      "bins": [
        "curl"
      ]
    },
    "emoji": "🧩",
    "os": [
      "darwin",
      "linux",
      "win32"
    ]
  },
  "hermes": {
    "tags": [
      "plantuml",
      "diagram",
      "flowchart",
      "sequence",
      "class",
      "uml",
      "architecture",
      "kroki"
    ],
    "category": "design",
    "requires_tools": [
      "curl"
    ],
    "related_skills": [
      "drawio",
      "mermaid",
      "excalidraw",
      "tldraw"
    ]
  },
  "author": "Agents365-ai",
  "version": "1.5.0"
}

README badge

README badge for agents365-ai/365-skills/plantuml-skill