{"id":"spillwavesolutions-plantuml","name":"plantuml","homepage":null,"repo_url":"https://github.com/SpillwaveSolutions/plantuml","category":"devtools","subcategories":[],"tags":["plantuml","diagrams-as-code","uml","cli","python","documentation","rendering","markdown","ci-cd"],"what_it_does":"CLI/Python “Claude Code skill” that helps create PlantUML diagrams from text, convert .puml/.md content into PNG/SVG images, validate PlantUML syntax, and support extracting/embedding diagrams from markdown workflows.","use_cases":["Generate UML/non-UML diagrams (sequence/class/activity/deployment/ER/Gantt/mindmap, etc.) from descriptions","Convert .puml files to PNG/SVG for documentation","Process markdown files to extract embedded/link .puml blocks and produce updated markdown with image links","Validate PlantUML syntax in CI/CD without rendering images","Convert source-code-oriented architectures into PlantUML-friendly diagram outputs (via skill guidance)"],"not_for":["A hosted diagram rendering API (everything described is local/CLI + plantuml.jar)","High-assurance enterprise diagram pipelines without reviewing dependencies and build/runtime hardening","Interactive diagram editing in the browser (this is generation/conversion-focused)"],"best_when":"You want a local, scriptable way to generate and render PlantUML diagrams (especially from markdown) and include images in docs/Confluence-like systems.","avoid_when":"You cannot install Java/plantuml.jar or Graphviz (Graphviz is recommended for most UML rendering).","alternatives":["PlantUML official server/CLI usage","Other diagram-as-code tools (Mermaid + renderers, dbdiagram for ER, Graphviz directly)","PlantUML plugins for IDEs and static site generators","PlantUML Maven/Gradle integrations (community examples)"],"af_score":47.2,"security_score":21.5,"reliability_score":32.5,"package_type":"skill","discovery_source":["openclaw"],"priority":"high","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-03-30T15:38:09.323203+00:00","interface":{"has_rest_api":false,"has_graphql":false,"has_grpc":false,"has_mcp_server":false,"mcp_server_url":null,"has_sdk":false,"sdk_languages":[],"openapi_spec_url":null,"webhooks":false},"auth":{"methods":[],"oauth":false,"scopes":false,"notes":"No authentication described; tool operates locally and invokes plantuml.jar/Graphviz via scripts/CLI."},"pricing":{"model":null,"free_tier_exists":false,"free_tier_limits":null,"paid_tiers":[],"requires_credit_card":false,"estimated_workload_costs":null,"notes":"No pricing information; appears to be an open-source/local utility."},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":[],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":47.2,"security_score":21.5,"reliability_score":32.5,"mcp_server_quality":0.0,"documentation_accuracy":70.0,"error_message_quality":null,"error_message_notes":"README mentions 'better error messages with line numbers' for markdown processing and provides troubleshooting guidance for common missing dependencies/syntax errors, but it does not show concrete error formats/codes.","auth_complexity":100.0,"rate_limit_clarity":0.0,"tls_enforcement":0.0,"auth_strength":0.0,"scope_granularity":0.0,"dependency_hygiene":50.0,"secret_handling":70.0,"security_notes":"Local execution via plantuml.jar and Graphviz; README does not discuss threat model for handling untrusted .puml/.md content (e.g., file path traversal, command injection in any wrapper scripts). No secrets/auth flows described. Ensure you do not render untrusted PlantUML/Graphviz inputs in shared environments without reviewing the scripts and runtime context.","uptime_documented":0.0,"version_stability":40.0,"breaking_changes_history":40.0,"error_recovery":50.0,"idempotency_support":"false","idempotency_notes":"Not documented. Converting files generally overwrites outputs, but idempotent behavior is not explicitly guaranteed.","pagination_style":"none","retry_guidance_documented":false,"known_agent_gotchas":["Requires local Java + plantuml.jar; failures will occur if binaries aren’t present/located or PATH/env is misconfigured","Graphviz is recommended/required for most diagrams (some types may not need it)","Markdown processing supports both embedded puml blocks and linked .puml files; agents should ensure paths/relative links are correct","Multiple scripts are mentioned (process_markdown_puml.py vs legacy extract_and_convert_puml.py); agents should prefer the documented enhanced script"]}}