ai-for-dummies/skill-reviews/improved/diagram-plantuml/SKILL.md

name, description

name	description
diagram-plantuml	Create a PlantUML diagram and a Confluence storage-format macro for a reviewed page. Use when a user needs a diagram embedded in a supported Confluence page.

diagram-plantuml

Inputs

The relationship to explain, target page context, and any approved diagram conventions.

Workflow

1. Choose a diagram type with references/diagram-types.md.
2. Build a small local .puml source with a caption and only approved includes.
3. Run a local syntax check when the configured renderer is available.
4. Return the storage macro and state whether syntax and target rendering were independently verified.

Rules

• Keep macro markup at the required storage-body level.
• Never load remote or untrusted !include sources.
• Do not claim a rendered result without a target-environment preview.

Output

Return the diagram source, storage macro, validation result, and any target-environment prerequisite.