CtrlK
BlogDocsLog inGet started
Tessl Logo

archify

Validated interactive HTML diagrams, upstream-maintained.

44

Quality

49%

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 ./optional-skills/creative/archify/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

61%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 body is a concise, well-structured catalog stub that appropriately defers to upstream documentation and signals install/validation behavior clearly. Its weak spots are the absence of a concrete diagram-generation usage example and an unenumerated core workflow.

Suggestions

Add a short Quick-start snippet showing a minimal JSON spec -> archify command -> HTML output so the primary action is executable without leaving the file.

Briefly enumerate the 9-check validate/deliver receipt (or link to where it is listed) so the validation workflow has explicit checkpoints rather than a reference.

List the diagram types (architecture, workflow, sequence, dataflow, lifecycle) as a scannable bullet list instead of inline prose to improve navigability.

DimensionReasoningScore

Conciseness

The body is a lean catalog stub that describes capabilities and install behavior without explaining concepts Claude already knows, and it carries no in-body version numbers or dates; it is not 5 because the catalog-stub blockquote and prerequisites prose could be trimmed slightly, fitting score 4 'efficient; minor instances of over-explanation that could be trimmed'.

4 / 5

Actionability

It gives concrete commands ('node bin/archify.mjs doctor', 'hermes skills install official/creative/archify') but provides no executable example of the core task — producing a diagram — and defers detail to the upstream README, matching score 3 'some concrete guidance but incomplete; missing key details'; not 4 because the primary usage path has no copy-paste example.

3 / 5

Workflow Clarity

Prerequisites are sequenced (Node 18+, doctor, check-update) and validation is referenced ('9-check validate / deliver receipt'), but the actual diagram-generation workflow is not enumerated with checkpoints, fitting score 3 'steps listed but validation gaps; checkpoints missing or implicit'; the destructive/batch cap does not apply as diagram generation is non-destructive.

3 / 5

Progressive Disclosure

The body is a well-organized overview under 50 lines with clear sections (Catalog stub, overview, Prerequisites) and a clearly signaled one-level-deep pointer to the upstream README; it is not 5 because detailed content is not split into locally navigable reference files (no bundle files exist), so navigation relies on an external URL, fitting score 4 'good structure; most content appropriately placed; references mostly clear'.

4 / 5

Total

14

/

20

Passed

Description

37%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 is a terse noun phrase that identifies the artifact type but omits action verbs and any 'Use when...' trigger guidance. It is moderately distinctive yet overlaps a documented sibling skill. Trigger phrases a user would naturally say are largely missing.

Suggestions

Add a verb-led 'what' clause, e.g. 'Generates validated, interactive HTML diagrams from a typed JSON spec or Mermaid input'.

Append an explicit 'Use when...' clause with natural triggers: 'Use when the user wants an architecture, workflow, sequence, dataflow, or state-machine diagram, or asks to convert Mermaid to explorable HTML'.

Include distinguishing keywords (architecture diagram, flowchart, sequence diagram, mermaid) so it does not collide with the architecture-diagram fallback skill.

DimensionReasoningScore

Specificity

The phrase 'Validated interactive HTML diagrams' names the domain but contains no action verbs (e.g. generates, converts, exports), matching the score-2 anchor 'Names the domain but actions are minimal or generic'; it is not score 1 because the domain is concrete, and not score 3 because no real concrete actions are listed.

2 / 5

Completeness

There is a terse 'what' (validated interactive HTML diagrams) but no 'when'/Use-when clause at all, so per the guideline a missing explicit trigger caps completeness at 3 ('clear what but when missing or weakly implied'); it is not 2 because the what is not vague, and not 4 because no when guidance exists.

3 / 5

Trigger Term Quality

Only 'interactive HTML diagrams' surfaces as a natural keyword; common trigger phrases a user would actually say ('architecture diagram', 'flowchart', 'sequence diagram', 'mermaid', 'convert to HTML') are absent, fitting score 2's 'one or two generic keywords; missing the natural phrases users say'.

2 / 5

Distinctiveness Conflict Risk

'Validated interactive HTML diagrams' is somewhat specific but the body itself flags overlap with the bundled 'architecture-diagram' skill, matching score 3 'somewhat specific but could still overlap with similar skills'; not 4 because the overlap with a closely related sibling skill is explicit.

3 / 5

Total

10

/

20

Passed

Validation

75%

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

Validation — 12 / 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

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

12

/

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.