CtrlK
BlogDocsLog inGet started
Tessl Logo

033-architecture-diagrams

Use when you need to generate Java project diagrams — including UML sequence diagrams, UML class diagrams, C4 model diagrams, UML state machine diagrams, UML Deployment Diagrams, ER (Entity Relationship) diagrams, and bounded-context diagrams — through a modular, step-based interactive process that adapts to your specific visualization needs. This should trigger for requests such as Generate UML diagram; Create sequence diagram; Create class diagram; Create state machine diagram; Create deployment diagram; Create C4 diagram; Create bounded-context diagram; Create context-map diagram. Part of Plinth Toolkit

75

Quality

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Content

85%

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

A well-structured interactive skill with a clear validated workflow and clean progressive disclosure into seven real reference files. Its main weakness is verbosity from restating the same diagram-family list and validation constraints across multiple sections.

Suggestions

Consolidate the diagram-family list: it currently appears in the description, 'What is covered in this Skill?', 'When to use this skill', Question 1 options, and the Reference section — keep one canonical list and reference it.

State the validate-and-stop-on-failure rule once: it is duplicated between the 'Constraints' section and Workflow step 1; a single authoritative statement avoids drift and saves tokens.

Tighten the question flow by condensing the repeated 'Ask this question only if you selected ... in Question 1' gating phrasing and the recurring 'Skip' options into a shared preamble.

DimensionReasoningScore

Conciseness

Mostly efficient and accurate but padded with redundancy: the seven diagram families are restated across the 'What is covered', 'When to use this skill', Question 1 options, and Reference sections, and the validate/stop-on-failure constraint is stated in both the Constraints block and Workflow step 1.

2 / 3

Actionability

Provides copy-paste-ready commands ('./mvnw validate', 'plantuml -checkonly diagrams', 'plantuml -tpng diagrams', 'plantuml -tsvg diagrams') and a concrete, option-by-option question flow with an explicit selection-to-reference mapping.

3 / 3

Workflow Clarity

Clear four-step sequence (validate → ask questions → read references and generate → validate and finalize) with explicit validation checkpoints and a stop-on-failure feedback loop before any generation.

3 / 3

Progressive Disclosure

SKILL.md is an overview that defers per-family implementation to seven one-level-deep references, all of which exist in ./references/, with a clear selection-to-reference mapping for navigation.

3 / 3

Total

11

/

12

Passed

Description

100%

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

A strong, specific description that names a comprehensive set of concrete diagram-generation capabilities, includes natural user-facing trigger phrases, and explicitly answers both what and when. The 'Part of Plinth Toolkit' tag is inert but harmless.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions and outputs — 'UML sequence diagrams, UML class diagrams, C4 model diagrams, UML state machine diagrams, UML Deployment Diagrams, ER ... diagrams, and bounded-context diagrams' — naming the domain and a comprehensive set of generation actions.

3 / 3

Completeness

Explicitly answers both what (the diagram families generated via a modular step-based process) and when via the 'Use when you need to generate Java project diagrams' clause plus 'This should trigger for requests such as...'.

3 / 3

Trigger Term Quality

Provides good coverage of natural trigger phrases users would say: 'Generate UML diagram; Create sequence diagram; Create class diagram; Create state machine diagram; Create deployment diagram; Create C4 diagram; Create bounded-context diagram; Create context-map diagram.'

3 / 3

Distinctiveness Conflict Risk

Targets a clear niche — Java project architecture/structure diagrams with named families (UML, C4, ER, bounded-context) — with distinct triggers unlikely to conflict with unrelated skills.

3 / 3

Total

12

/

12

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
jabrena/plinth
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.