---
author: 'Marcos Silva'
description:
  '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.'
extras:
  'Add fixtures for malformed diagrams, missing macro support, and approved
  standard-library includes.'
focus:
  'Produce a valid PlantUML diagram and Confluence storage macro for a reviewed
  page.'
id: 'diagram-plantuml'
improve:
  - 'Do not imply that a Confluence macro is installed or renders without
    checking the target environment.'
  - 'Allow only approved, bundled includes; do not fetch untrusted includes at
    render time.'
  - 'Report syntax validation separately from a confirmed rendered preview.'
name: 'diagram-plantuml'
path: '../submitted-skills/Marcos%20Silva/skills/diagram-plantuml/SKILL.md'
status: 'Useful focused helper'
title: 'PlantUML diagram'
wins:
  - 'Focused macro guidance and useful diagram-type and troubleshooting
    references.'
  - 'Optional local syntax check is a sensible quality gate.'
---

# 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.
