CtrlK
BlogDocsLog inGet started
Tessl Logo

architecture-diagram

Dark-themed SVG architecture/cloud/infra diagrams as HTML.

56

Quality

65%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/creative/architecture-diagram/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

80%

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

The content is a tight, highly actionable reference with concrete color, typography, and layout specs, weakened only by a missing output-verification step in the workflow and a dead template reference it instructs Claude to load.

Suggestions

Add a verification step to the workflow (e.g. after saving, confirm the HTML opens and renders with no overlapping legend) to close the validation gap.

Provide the referenced templates/template.html (or inline its essentials) so the "load the full template" instruction resolves to a real file.

If no bundle is intended, replace the skill_view template instruction with a self-contained inline skeleton to avoid a broken reference.

DimensionReasoningScore

Conciseness

The body is lean reference material — exact rgba/hex fills, px font sizes, stroke widths, and spacing values — with no over-explanation of SVG/HTML concepts Claude already knows; nearly every token earns its place.

3 / 3

Actionability

It provides concrete, copy-paste-ready specs (color table with rgba/hex, grid pattern SVG, double-rect masking steps, info-card HTML snippet, exact px layout rules), giving fully executable guidance for generation.

3 / 3

Workflow Clarity

The four-step generate-save-open workflow is clearly sequenced, but there is no explicit verification checkpoint (e.g. confirming the HTML renders) despite a flagged CRITICAL legend-placement constraint, matching the "steps listed but validation gaps" anchor.

2 / 3

Progressive Disclosure

The body is well-organized into clear sections, but its single one-level-deep external reference — skill_view(... "templates/template.html") — points to a file that does not exist in the bundle, so the advertised progressive-disclosure target is broken.

2 / 3

Total

10

/

12

Passed

Description

50%

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 clear and on-domain but static: it describes the artifact rather than actions and omits any "Use when..." trigger guidance. Adding an explicit trigger clause and a verb like "Generate" would lift specificity and completeness.

Suggestions

Lead with an action verb, e.g. "Generate dark-themed SVG architecture/cloud/infra diagrams as standalone HTML files," to convert the noun phrase into concrete capabilities.

Add a "Use when..." trigger clause naming natural user phrasings (e.g. "Use when the user wants an architecture, cloud, or infrastructure diagram").

Include the full word "infrastructure" and terms like "system diagram" / "topology" to broaden natural trigger coverage.

DimensionReasoningScore

Specificity

The description names a concrete domain and artifact ("Dark-themed SVG architecture/cloud/infra diagrams as HTML") but uses no action verbs, describing the output rather than listing concrete actions; not vague enough for 1 but not the multi-action listing that earns 3.

2 / 3

Completeness

It answers what the skill produces but contains no "Use when..." clause or equivalent trigger guidance; per the guidelines a missing trigger clause caps completeness at 2.

2 / 3

Trigger Term Quality

Relevant natural terms are present (architecture, cloud, infra, SVG, diagrams, HTML), but common variations like "infrastructure", "system diagram", and "topology" are missing, matching the "some relevant keywords but missing common variations" anchor.

2 / 3

Distinctiveness Conflict Risk

The dark-themed SVG architecture/cloud niche is fairly specific, but "diagrams" broadly overlaps with sibling skills (concept-diagrams, excalidraw are noted as related), placing it at "somewhat specific but could still overlap".

2 / 3

Total

8

/

12

Passed

Validation

81%

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

Validation13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

13

/

16

Passed

Repository
NousResearch/hermes-agent
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.