Plantuml check

Skill xylvvv/agent-skills/skills/plantuml-check

Install

npx -y skills add xylvvv/agent-skills --skill plantuml-check

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Use when validating, syntax-checking, or optionally rendering PlantUML .puml files, especially before claiming generated diagrams are valid or when another skill produces PlantUML artifacts.

SKILL.md

2.1 KB, as published. Nobody here has run it

PlantUML Check

Purpose

Use this skill to verify PlantUML .puml files with the strongest available local method. Prefer render-level validation when tooling exists, and fall back to explicit static checks when it does not.

Core Rules

Validate the .puml source with a PlantUML-compatible renderer when possible.
PNG/SVG generated by a PlantUML-compatible renderer is valid render-level evidence; generative or manually produced images are not.
Do not send diagram content to a public network service unless the user explicitly allows it.
Report the validation method used: plantuml-cli, plantuml-jar, docker, podman, kroki, or static.
If only static validation was possible, state that render-level validation was not completed.

Quick Start

Run the bundled checker:

python skills/plantuml-check/scripts/check_plantuml.py docs/trace-code-flow
python skills/plantuml-check/scripts/check_plantuml.py docs/trace-code-flow --format svg --out-dir /tmp/puml-check
python skills/plantuml-check/scripts/check_plantuml.py docs/trace-code-flow --json

Use network rendering only when explicitly permitted:

python skills/plantuml-check/scripts/check_plantuml.py docs/trace-code-flow \
  --kroki-url http://internal-kroki/render --allow-network

Workflow

Identify .puml files or directories to validate.
Run scripts/check_plantuml.py against those paths.
Read the method and summary from the output.
Treat render_level_validation=false as a weaker result, not a failure by itself.
Fix failed files before claiming the diagrams are valid.

Exit Codes

0: all files passed render-level validation or static fallback validation.
1: at least one file failed validation.
2: usage error, missing path, or no .puml files found.

More Detail

See references/validation-strategy.md for renderer priority, safety rules, and expected reporting language.