Plantuml skill

Professional PlantUML and C4 diagram skill for architecture visualization, sequence flows, and technical documentation.

Install

npx -y skills add jovd83/plantuml-skill

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

One thing to look at

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

Enterprise-grade engine for rendering professional PlantUML and C4 diagrams. Optimized for system architecture visualization, sequence flow modeling, and high-fidelity project documentation.

SKILL.md

3.0 KB, as published. Nobody here has run it

PlantUML Skill (v2.0)

Mission

To transform unstructured engineering concepts into grounded, syntactically correct, and visually premium diagrams while managing all underlying infrastructure (Java, Graphviz) autonomously.

🧠 Cognitive Process (Think-Act-Verify)

1. Think

Grounding: Extract actors, states, and relationships from the provided context.
Selection: Choose the optimal diagram type (Sequence for logic, C4 for architecture, State for lifecycles).
Theme: Always target the assets/premium-theme.puml for professional aesthetics.

2. Act (Generate & Render)

Drafting: Write the .puml code. Use absolute paths for the !include if possible, or relative paths if the root is known.
Rendering: Execute the renderer script: python scripts/render.py --input <file>.puml --output <dir> --format svg,png

3. Verify

Syntax Check: Ensure no 404s for C4 libraries.
Visual Check: Confirm the premium theme is active.
Artifact Check: Verify both SVG (scalable) and PNG (compatible) files are produced.

📋 Input Contract (JSON)

{
  "source_context": "string",
  "diagram_type": "sequence | c4 | state | class | activity",
  "output_name": "string (basename)",
  "use_premium_theme": true
}

📋 Output Contract (JSON)

{
  "puml_file": "path/to/source.puml",
  "svg_file": "path/to/diagram.svg",
  "png_file": "path/to/diagram.png",
  "render_status": "success | failure"
}

🛡 Safeguards & Guardrails

Complexity Limit: For diagrams exceeding 50 lines, suggest splitting into sub-diagrams.
C4 Library: Only use plantuml-stdlib/C4-PlantUML/master/ URLs.
Environment: If rendering fails, run python scripts/render.py --setup once before retrying.

📚 Documentation

Refer to:

docs/syntax-guide.md: UML and C4 syntax best practices.
docs/troubleshooting.md: Recovery steps for Java/Graphviz issues.
CHANGELOG.md: Version history and migration notes.