concept-diagrams

Generate flat, minimal educational SVG visuals as HTML.

Quality

71%

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

Fix and improve this skill with Tessl

tessl review fix ./optional-skills/creative/concept-diagrams/SKILL.md

Quality

Content

88%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 SKILL.md body is highly actionable and well-structured, with executable boilerplate, concrete patterns, and an explicit validation checklist driving strong workflow clarity. Its main gap is referencing bundle paths (templates/template.html, examples/) that are not present alongside the verified references/*.md files.

Suggestions

Ship or remove the referenced templates/template.html and examples/ directory so every path named in the body exists in the bundle, closing the progressive-disclosure gap.

De-duplicate the arrow <defs> marker block (shown in both the Design System and SVG Boilerplate sections) to tighten conciseness.

Consider folding the large color-palette table into a references file and keeping only the assignment rules inline, to further reduce SKILL.md token weight.

Dimension	Reasoning	Score
Conciseness	The body is efficient and assumes competence—palette tables, stroke rules, and node patterns are necessary spec rather than padded concept explanation—with only minor repetition (the arrow <defs> block appears twice), fitting 'efficient; minor instances that could be trimmed' rather than fully lean.	4 / 5
Actionability	It provides copy-paste ready SVG boilerplate, concrete node/connector/container patterns, executable Python and bash snippets, and precise validation formulas, fully covering the common cases as the 'fully executable; copy-paste ready' anchor requires.	5 / 5
Workflow Clarity	A clear numbered workflow is paired with an explicit 12-item Validation Checklist and a feedback-style 'verify ALL of the following' gate before finalizing, plus security guidance for the optional server, matching 'clear sequence with explicit validation steps; checklists for complex processes.'	5 / 5
Progressive Disclosure	Content is well split with one-level-deep, clearly signaled references to references/physical-shape-cookbook.md, references/infrastructure-patterns.md, and references/dashboard-patterns.md (all present), but templates/template.html and the examples/ directory are referenced yet absent from the bundle, a minor organization gap that keeps it below 5.	4 / 5
	Total	18 / 20 Passed

Description

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

The description states the skill's purpose clearly and carves out a reasonably distinct niche, but it lacks a 'Use when...' trigger clause and omits common user-facing synonyms like 'diagram' or 'chart', leaving the what/when pairing incomplete.

Suggestions

Add an explicit 'Use when...' clause with concrete trigger phrases, e.g. 'Use when creating diagrams, charts, or educational visuals from physics, chemistry, math, or engineering subjects.'

Include natural synonyms users say ('diagram', 'chart', 'visualization') and a representative file extension or output mention to broaden trigger coverage.

List one or two more concrete actions (e.g. 'render to a standalone HTML file with light/dark mode') to lift specificity from 1-2 actions toward comprehensive coverage.

Dimension	Reasoning	Score
Specificity	Names the domain ('SVG visuals', 'HTML') and a couple of concrete traits ('flat', 'minimal', 'educational'), but does not enumerate multiple specific generation actions, so it stops at the 1-2 concrete actions anchor rather than the comprehensive 5.	3 / 5
Completeness	It gives a clear 'what' (generate flat minimal educational SVG visuals as HTML) but contains no 'Use when...' clause or equivalent trigger guidance, which per the guidelines caps completeness at 3.	3 / 5
Trigger Term Quality	Includes a few natural terms ('SVG', 'HTML', 'educational') but omits common variations users actually say ('diagram', 'chart', 'visualization', file extensions), so it lands at 'some relevant keywords but missing synonyms' rather than good coverage.	3 / 5
Distinctiveness Conflict Risk	The 'flat, minimal educational SVG visuals as HTML' niche is mostly distinct with only minor overlap risk against closely related diagram skills, fitting the 'mostly distinct' anchor above the midpoint.	4 / 5
	Total	13 / 20 Passed

Validation

81%

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 — 13 / 16 Passed

Validation for skill structure

Criteria	Description	Result
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
Path: optional-skills/creative/concept-diagrams/SKILL.md
Commit: 6680afb

Reviewed: about 3 hours 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.