CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

architecture-diagram

Create polished dark-themed architecture diagrams as self-contained HTML+SVG files. Use when the user asks for system, infrastructure, cloud, security, or network topology diagrams.

Quality

82%

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

The canonical home for this skill is architecture-diagram in Cocoon-AI/architecture-diagram-generator

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.

The content is highly actionable and efficient, with concrete SVG/CSS patterns and strong preventive correctness rules for layout. Its main defects are a dangling reference to a nonexistent template file and the absence of an explicit final validation step.

Suggestions

Ship the actual resources/template.html in the bundle or inline a minimal template skeleton in SKILL.md — the primary workflow step ("Copy and customize the template at resources/template.html") currently points to a file that does not exist.

Add an explicit post-build validation step (e.g., "Before finalizing, verify no component overlaps, message buses sit centered in their gaps, and the legend is below the lowest boundary") to convert the spacing/legend rules into a checklist.

Trim known-concept explanations (e.g., the SVG document-order z-order sentence) and consider moving the export-toolbar spec and SRI hash details into a reference file to slim SKILL.md.

DimensionReasoningScore

Conciseness

The body is dominated by skill-specific values (exact rgba/hex colors, font sizes, SVG patterns) with only minor over-explanation of known concepts (e.g., "SVG elements are painted in document order, so arrows drawn first will appear behind shapes drawn later") and slightly redundant Wrong/Right restatements, matching anchor 4.

4 / 5

Actionability

Guidance is fully executable: copy-paste-ready SVG snippets (grid pattern, arrowhead marker, component box pattern, info card), exact color and typography specs, pinned CDN URLs with SRI hashes, and a numbered 6-point customization checklist, matching anchor 5.

5 / 5

Workflow Clarity

A clear sequence exists (copy template, 6 numbered customization points, output requirements) supported by many inline correctness checkpoints (spacing math, legend placement, z-order masking rules), but there is no explicit post-generation validation step, so it matches anchor 4 rather than 5.

4 / 5

Progressive Disclosure

Sections are well-organized, but the body's central instruction references "resources/template.html" which does not exist in the bundle (no references/, scripts/, assets/, or resources/ directories), and ~170 lines of spec content (export toolbar details, SRI hashes) are inlined that could live in separate reference files, matching anchor 3.

3 / 5

Total

16

/

20

Passed

Description

78%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.

A strong description with an explicit "Use when..." clause and natural trigger terms covering the main diagram types. Its only weakness is that the capability statement is a single action rather than a fuller list of what the skill produces.

DimensionReasoningScore

Specificity

"Create polished dark-themed architecture diagrams as self-contained HTML+SVG files" names the domain and output medium but covers only one concrete action; it does not enumerate several capabilities (arrows/connections, security groups, legends, PNG/PDF export), matching anchor 3 rather than 4.

3 / 5

Completeness

The description explicitly answers both: what ("Create polished dark-themed architecture diagrams as self-contained HTML+SVG files") and when ("Use when the user asks for system, infrastructure, cloud, security, or network topology diagrams") with concrete trigger phrases, exactly matching anchor 5.

5 / 5

Trigger Term Quality

"system, infrastructure, cloud, security, or network topology diagrams" are natural phrases users would say, giving good keyword coverage, but common synonyms ("architecture diagram", "draw", file-type cues) are missing, so it is not the comprehensive coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

The niche (dark-themed architecture/topology diagrams as HTML+SVG) is mostly distinct, but triggers like "cloud" and "security diagrams" carry minor overlap risk with general charting or diagramming skills, matching anchor 4 rather than the minimal-conflict profile of anchor 5.

4 / 5

Total

16

/

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

KennethJefferson/CustomCommand_Arch2Image

Path

__solutions/fork_architecture-diagram-generator/architecture-diagram/SKILL.md

Revision

c6fb99e

Reviewed

Table of Contents

DiscoveryImplementationValidation

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.

Claim skill