CtrlK
BlogDocsLog inGet started
Tessl Logo

neva-to-mermaid

Convert Neva programs to valid Mermaid flowchart diagrams. Use when asked to visualize Neva code as Mermaid.

66

Quality

78%

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 ./.codex/skills/neva-to-mermaid/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

A lean, concrete, well-structured conversion skill whose rules are directly executable. The main weakness is the incomplete reference example (Neva input only, no Mermaid output), which costs it actionability and weakens the verification story.

Suggestions

Complete the Reference Example by adding the corresponding Mermaid `flowchart TB` output for the shown Neva `Tap` definition, so there is a full input→output worked example.

Replace the soft step 4 ("Ensure the output is ready to be pasted into the Mermaid playground") with an explicit validation checkpoint — e.g., confirm every node ID is unique, every `[...]` list-wiring has a junction node, and re-render mentally before emitting.

Tighten the Fan-out/Fan-in section by consolidating the repeated "Insert a junction node / Wire" phrasing into a single compact pattern, trimming "IMPORTANT"/"MUST" emphasis markers.

DimensionReasoningScore

Conciseness

The body states conversion rules directly with concrete Mermaid syntax (e.g., `([":data"])`, `jX(( ))`, `zero@{ label: "0", shape: rect }`) and assumes Claude knows Mermaid, so it is efficient. It is below 5 because the fan-out/fan-in section repeats structural patterns and markers like "IMPORTANT"/"MUST" add mild padding, but above 3 since nothing teaches concepts Claude already knows.

4 / 5

Actionability

Rules give copy-paste-ready Mermaid snippets and explicit labeled/unlabeled-edge examples ("x:res -> y → label edge as res"), which is mostly executable guidance. It is not 5 because the "Reference Example" shows only the Neva input with no corresponding Mermaid output, leaving the single most actionable artifact — a complete worked input→output example — missing; it stays above 3 because the rules themselves are concrete and executable rather than pseudocode.

4 / 5

Workflow Clarity

A clear four-step sequence (read → generate per rules → do not look up files → ensure playground-ready output) is present. It is below 5 because step 4 ("Ensure the output is ready to be pasted into the Mermaid playground") is a soft verification rather than an explicit validate-and-fix feedback loop, but above 3 because the sequence is unambiguous and this is a single-purpose conversion (not a destructive/batch operation that would trigger the 3-cap).

4 / 5

Progressive Disclosure

The skill is a single self-contained file with well-organized sections (Instructions, Reference Example) and no nested or buried references, and no bundle files exist to reference. It is below 5 because the body exceeds 50 lines (~85) so the simple-skill 5-exception does not fully apply, but above 3 because structure is clean and all content is appropriately placed in one file.

4 / 5

Total

16

/

20

Passed

Description

82%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 concise, well-formed description that clearly states both capability and trigger. Its only limitation is narrow action coverage (a single conversion action) and a small keyword set, which keep specificity and trigger_term_quality just below the top band.

DimensionReasoningScore

Specificity

"Convert Neva programs to valid Mermaid flowchart diagrams" names the domain and one concrete action (conversion to flowcharts), but offers only a single action rather than several specific capabilities. It is above 2 (the action is concrete, not minimal/generic) but below 4 (which requires several specific actions).

3 / 5

Completeness

It explicitly answers both "what" ("Convert Neva programs to valid Mermaid flowchart diagrams") and "when" ("Use when asked to visualize Neva code as Mermaid") with a concrete trigger phrase, matching the 5 anchor. It is not 4 because the "when" is explicit and specific, not merely implied.

5 / 5

Trigger Term Quality

Natural terms a user would say are present — "Neva", "Mermaid", "flowchart", "visualize Neva code as Mermaid" — giving good keyword coverage. It is below 5 because there are no synonyms or file extensions (e.g., ".neva") and the term set is narrow, but above 3 because the natural phrasing is well captured.

4 / 5

Distinctiveness Conflict Risk

The Neva-to-Mermaid niche is highly specific with distinct triggers, creating minimal conflict risk with other skills. It clearly matches the 5 anchor ("clear niche with distinct triggers").

5 / 5

Total

17

/

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
nevalang/neva
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.