Diagramming

Owns repo-local diagramming guidance for draw.io and Mermaid workflows. Use this skill for diagram source edits, preview/export decisions, layout checks, color/asset conventions, and diagram-focused validation.

1. Scope

• draw.io .drawio source creation, editing, review, and export.
• draw.io layout, color palette, shape vocabulary, and AWS icon usage.
• Mermaid diagrams in Quarto revealjs .qmd files.
• Mermaid CLI preview, %%{init}%% configuration, CSS overrides, and layout

validation.

• Diagram-focused scripts and reference assets.

Out of scope:

• Data-platform workflows; use data-platform.
• GitHub issue, PR, review, or public-surface mechanics; use

dev-platform-workflow.

• Generic Bash, Python, Nix, Markdown, or implementation-loop work; use

programming.

• Agent harness runtime, hooks, postman routing, or installed agent outputs;

use dotfiles.

2. Workflow

1. Inspect the diagram source, nearby conventions, and git status.
2. Choose the focused reference below before editing or validating diagrams.
3. Preserve editable source files; treat generated exports as reproducible

outputs unless the surrounding workflow requires them.

1. Verify rendered dimensions, text contrast, and overlap when diagram layout

changes are user-visible.

1. Run the nearest diagram or Markdown checks before reporting success.

3. References

• [draw.io](references/drawio.md)
• [Mermaid](references/mermaid.md)