CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

uml-and-software-architecture-visualization

Design, critique, read, write, render, and implement UML and UML-like software diagrams. Use when the user mentions UML, sequence diagrams, class diagrams, activity diagrams, state machines, use case diagrams, component diagrams, deployment diagrams, object diagrams, package diagrams, profile diagrams, timing diagrams, communication diagrams, interaction overview diagrams, composite structure diagrams, ERDs, database schema diagrams, C4, BPMN, swimlanes, flowcharts, network diagrams, application architecture diagrams, software architecture diagrams, diagram-as-code, model-as-code, XMI, UMLDI, PlantUML, Mermaid, Graphviz DOT, D2, Structurizr, DBML, diagrams.net/draw.io, Kroki, or interactive diagram editors and explorers.

71

Quality

89%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

78%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-engineered decision-guide skill: a clear 10-step selection workflow, concrete tool and notation defaults, and clean one-level-deep reference files confirmed to exist. It loses points for repeated routing to the same adjacent skills, abstract passages like the normalized model contract, and validation being mentioned as a deliverable rather than embedded as workflow checkpoints.

Suggestions

Consolidate the five repeated mentions of `../node-link-and-diagram-layout/SKILL.md` into one routing decision (e.g., in Overview plus the Reference Guide) and remove the duplicated mobile/workspace guidance between Core Workflow step 10, Output Expectations, and Adjacent Skills.

Make the 'normalized model contract' directive concrete with a short inline example (a 5-10 line JSON snippet showing nodes, edges, ports, and layoutHints) or point to a section in a reference file that defines it.

Add explicit validation checkpoints to the Core Workflow, e.g. a step that says to run semantic validation on the diagram source (or visual-regression fixtures for layout) and fix-and-retry before export or delivery.

DimensionReasoningScore

Conciseness

The body is dense, opinionated bullet guidance with no tutorial padding ('Sequence diagram: message order across actors, services, or objects'), but it is not fully lean: routing to `../node-link-and-diagram-layout/SKILL.md` is repeated five times (Overview, Core Workflow step 6, Stack Defaults, Reference Guide, Adjacent Skills), and mobile/workspace guidance recurs in Core Workflow step 10, Output Expectations, and Adjacent Skills. That repetition keeps it at 4 rather than 5; it is well above 3 because nothing explains concepts Claude already knows.

4 / 5

Actionability

Guidance is concrete for a decision skill: named tools per scenario ('prefer DBML... Mermaid ER, or PlantUML IE/ER'; 'React Flow for editable node-edge UIs, Cytoscape.js for graph analysis... ELK or Dagre for auto-layout') and specific output requirements ('route foreign keys in dedicated gutters or ports; never let connectors run underneath table boxes'). It falls short of 5 because some directives stay abstract — 'Define the normalized model contract before rendering: nodes, edges, compartments, ports...' lists fields but gives no example of the contract, and there is no worked selection example showing the rules applied.

4 / 5

Workflow Clarity

The Core Workflow is a coherent 10-step decision sequence from modeling job through audience, notation, format, renderer, model contract, and export/testing, with concrete sub-criteria at each step. Validation appears only as a planning item ('semantic validation, and visual regression where layout matters') rather than explicit checkpoints in the sequence, and there are no validate-then-proceed feedback loops, which keeps it below 5; the sequence is complete and well-ordered, clearly above the 3 anchor's implicit-checkpoint gap.

4 / 5

Progressive Disclosure

The body is a concise overview plus decision rules, with a Reference Guide that signals exactly when to open each of five real one-level-deep files ('Read `references/formats-and-interchange.md` before reading, writing, converting, or round-tripping diagram formats'); all five referenced files exist and contain no further nested references. Cross-links to adjacent skills are peers, not nested detail. This matches the clear-overview-with-well-signaled-references anchor.

5 / 5

Total

17

/

20

Passed

Description

96%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

An exemplary description: explicit what-and-when structure, six concrete verbs, and an unusually comprehensive trigger list covering diagram types, interchange formats, and tool names in third person. The only soft spot is slight breadth ('flowcharts', 'network diagrams') that overlaps neighboring visualization skills.

DimensionReasoningScore

Specificity

The description lists six concrete actions — 'Design, critique, read, write, render, and implement' — applied to a clearly named domain ('UML and UML-like software diagrams'), matching the comprehensive-coverage anchor. Not a 4 because no concrete action category for this domain is obviously missing; not below 5 because the verbs are specific rather than generic filler.

5 / 5

Completeness

Both halves are explicit: what ('Design, critique, read, write, render, and implement UML and UML-like software diagrams') and when ('Use when the user mentions UML, sequence diagrams, ... or interactive diagram editors and explorers') with concrete trigger phrases. This mirrors the 5-anchor example structure exactly; a 4 would require a weaker or less explicit 'when' clause.

5 / 5

Trigger Term Quality

Trigger coverage is exhaustive: 'UML, sequence diagrams, class diagrams, activity diagrams, state machines... ERDs, database schema diagrams, C4, BPMN, swimlanes, flowcharts... PlantUML, Mermaid, Graphviz DOT, D2, Structurizr, DBML, diagrams.net/draw.io, Kroki'. This includes diagram-type synonyms, format names, tool names, and vendor-specific spellings, matching the comprehensive-coverage anchor including synonyms.

5 / 5

Distinctiveness Conflict Risk

The niche is distinct — formal/UML-family diagramming with named notations and tools — but broad terms like 'network diagrams', 'flowcharts', and 'diagram-as-code' create minor overlap with general graph-visualization and node-link layout skills. Mostly distinct with minor overlap risk against closely related skills fits the 4 anchor better than 5, whose example stakes out a uniquely owned file type and trigger set.

4 / 5

Total

19

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

openai/plugins

Path

plugins/build-web-data-visualization/skills/uml-and-software-architecture-visualization/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.