bpmn

Create business process diagrams using PlantUML syntax with BPMN, EIP, and Lean Mapping stencil icons. Best for workflow automation, approval chains, message-based integration patterns, and value stream mapping.

Quality

91%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

92%Weight 40%Scale 1-3

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

The body is an excellent, lean, actionable reference with a clear quick-start workflow and runnable example. Its one real defect is progressive disclosure: every external reference (the stencils README and all eight example files) points to a path absent from the bundle, so the offloaded content cannot actually be reached.

Suggestions

Bundle the referenced files: create examples/ with the eight cited .md files (order-processing.md, approval-workflow.md, eip-messaging.md, etc.) and ensure ../uml/stencils/README.md exists, or rewrite the links to point at paths that are actually shipped.

If the examples and full stencil listing are not intended to ship, remove the dangling links and inline the essential subset the skill needs so navigation never dead-ends.

Verify the stencils/README.md link path relative to the skill's install location, since "../uml/stencils/" assumes a sibling-directory layout that is not present here.

Dimension	Reasoning	Score
Conciseness	The body is dense reference data — icon tables, syntax rules, and a runnable example — with no concept padding (it never explains what BPMN or PlantUML is), so every token earns its place per the score-3 anchor.	3 / 3
Actionability	It gives exact syntax ("mxgraph.<library>.<icon> \"Label\" as <alias>"), a connection-type table, and a complete copy-paste-ready PlantUML example with @startuml/@enduml and real icon aliases, matching the fully-executable score-3 anchor.	3 / 3
Workflow Clarity	The "Quick Start" lays out a clear sequenced flow ("Choose diagram type → Declare stencil icons → Group into pools/lanes → Connect with arrow syntax → Wrap in ```plantuml") and the Critical Rules act as a checklist; for this non-destructive single-purpose skill the simple-skill note permits a 3 without validation checkpoints.	3 / 3
Progressive Disclosure	References are clearly signaled and one-level-deep ([stencils/README.md](../uml/stencils/README.md) and eight examples/*.md links), but none of these paths exist in the bundle — there is no examples/, references/, or ../uml/stencils/ directory — so the disclosed material is unreachable, fitting the score-2 anchor of references that do not resolve rather than the score-1 monolithic-wall anchor.	2 / 3
	Total	11 / 12 Passed

Description

90%Weight 40%Scale 1-3

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

The description is strong: it pairs a concrete action with explicit "Best for..." trigger guidance covering natural use-case terms, giving it a clear, distinctive niche. Its only weakness is specificity, since it lists a single action rather than multiple distinct capabilities.

Dimension	Reasoning	Score
Specificity	Quotes "Create business process diagrams using PlantUML syntax with BPMN, EIP, and Lean Mapping stencil icons" name the domain and one concrete action with method detail, but only a single verb ("Create") is given rather than the multiple distinct actions the score-3 anchor requires.	2 / 3
Completeness	It states what ("Create business process diagrams...") and gives equivalent explicit trigger guidance via "Best for workflow automation, approval chains...", satisfying both halves and avoiding the missing-'Use when' cap at 2.	3 / 3
Trigger Term Quality	"workflow automation, approval chains, message-based integration patterns, and value stream mapping" plus "business process diagrams" give good coverage of natural phrases a user would say, matching the score-3 anchor's breadth despite some mixed jargon (EIP, PlantUML).	3 / 3
Distinctiveness Conflict Risk	The BPMN/EIP/Lean Mapping diagram niche with PlantUML and triggers like "approval chains" and "value stream mapping" is a clear, distinctive domain unlikely to fire for unrelated skills.	3 / 3
	Total	11 / 12 Passed

Validation

87%

Warnings & errors only

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

Validation — 14 / 16 Passed

Validation for skill structure

Criteria	Description	Result
metadata_version	'metadata.version' is missing	Warning
relative_links	Relative link issues: 8 missing, 1 suspicious	Warning

	Total	14 / 16 Passed

Repository: markdown-viewer/skills
Path: bpmn/SKILL.md
Commit: a3afd45

Reviewed: ~1 month ago

Table of Contents

Discovery Implementation Validation

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.