Individual skill
diagram-quality
PlantUML diagram quality on the agent-uml collaborative canvas — three tiers: rendering safety (syntax that prevents HTTP 400 blank canvas), conversation mechanics (when to push a version vs ask a question, what to write in the message parameter), and design effectiveness (decomposition thresholds, cross-diagram traceability, export readiness). Trigger whenever calling agent-uml MCP tools (design_create, diagram_upsert, design_feedback, design_export) — even when the task seems simple, since a missing `as alias` makes elements un-annotatable and a skinparam mismatch makes diagrams unreadable.
skills/.experimental/diagram-quality/SKILL.md
Source commit cf93c57cac89d6fc3e4194686000411567f5caf3
What was checked
- Matches the observed repository HEAD
- Yes
- Scanner rules are current
- Yes
- Repository scan complete
- No
- Skill scan complete
- Yes
- Observed behavior
- Instructions only
- Last checked
- Nov 5, 2026
These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.
Install this skill
Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.
An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.
Repository context
- Repository stars (not skill ratings)
- 221
- Repository last updated
- Aug 15, 2026
- License
- MIT
Observed agent integration: codex
- design Derived category
Files and excerpt
File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.
Browse files
AGENTS.mddoc · 1,719 bytesSKILL.mdcore · 4,537 bytesassets/templates/_template.mddoc · 607 bytesmetadata.jsonasset · 596 bytesreferences/_conversation.mddoc · 9,520 bytesreferences/_design.mddoc · 7,905 bytesreferences/_presets.mddoc · 4,481 bytesreferences/_sections.mddoc · 1,640 bytesreferences/syn-safety.mddoc · 11,982 bytes
Read excerpt
# agent-uml Diagram Quality Best Practices
Make the human-Claude design conversation converge faster on the agent-uml canvas.
## When to Apply
- Before every `diagram_upsert` call — check syntax safety rules and apply the correct skinparam preset
- After every `design_feedback` response — consult the versioning decision table to choose the right next action
- When starting a new design session — follow the progressive detail layers for diagram ordering
- Before calling `design_export` — run the export-readiness checklist
- When a diagram renders blank or elements aren't clickable — consult rendering safety rules
## Rule Categories by Priority
| Priority | Section | Impact | Reference |