CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

visual-thinking

Turn an idea, change or decision into a visual HTML canvas with Mermaid diagrams. Trigger: visualizá esto, canvas.

65

Quality

82%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

93%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 an exemplary lean skill: operational rules, a crisp four-step process, exact commands and paths, and clean one-level-deep references to real bundle files. The only minor gap is the absence of an explicit validation checkpoint on the rendered output, which keeps workflow_clarity at 4.

DimensionReasoningScore

Conciseness

The ~46-line body is lean and fully operational: "Render when the discussion has >=3 moving parts", "2–5 blocks per canvas", "One diagram, one point. If a diagram needs a paragraph, redraw the diagram." No concept explanations or padding — every token earns its place. Not below 5 because nothing can be trimmed without losing instruction.

5 / 5

Actionability

For an instruction-only skill the guidance is fully concrete: exact output path pattern ("`<tmpdir>/visual-thinking-<timestamp>.html` (`%TEMP%` on Windows, `$TMPDIR` or `/tmp` elsewhere)"), open commands ("`start` / `open` / `xdg-open`"), and a seven-type block taxonomy with one-line selection guidance. The deferred details live in real bundle files (references/diagrams.md, assets/canvas-template.html). Anchor 5; the absence of code is not penalized because the guidance is directly executable.

5 / 5

Workflow Clarity

A clear four-step sequence (Extract → Compose → Render → Feed back) with a go/no-go gate (rule 1: ">=3 moving parts"), an explicit failure check ("If the canvas restates everything already said in chat, it failed") and a regeneration rule ("never edit diagrams in place"). Scored 4 rather than 5 because there is no explicit validation/retry checkpoint on the rendered output itself (e.g. verifying the file opened or Mermaid rendered) — a minor gap, though the operation is low-risk (temp file, nothing in the repo).

4 / 5

Progressive Disclosure

The body is a clear, well-organized overview that splits detail correctly: the diagram/HTML contract in [references/diagrams.md] and the shell in [assets/canvas-template.html], both clearly signaled one-level-deep links, and both files exist with real content. Easy navigation, no inlining of content that belongs in separate files.

5 / 5

Total

19

/

20

Passed

Description

62%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 clearly states what the skill does and includes an explicit trigger clause, but its trigger coverage is thin (one Spanish phrase and one generic keyword) and the capability list is narrow. It is serviceable but below the bar set by the good examples, which enumerate both actions and natural trigger phrases.

Suggestions

Add natural trigger phrases users would actually say in English as well (e.g. "visualize this", "diagram this", "map the options") alongside "visualizá esto" — trigger_term_quality is the heaviest-weighted dimension and currently leans on a single phrase.

State the "when" situationally, not just by keyword: e.g. "Use when a discussion has 3+ moving parts (options, unknowns, flows, decisions)" — this would move completeness from 4 to 5.

Name one or two more concrete capabilities in the description (e.g. "pick from idea maps, before/after deltas, options and decision trees; export to PNG/PDF") to raise specificity beyond a single composite action.

DimensionReasoningScore

Specificity

"Turn an idea, change or decision into a visual HTML canvas with Mermaid diagrams" names the domain and one composite action, but lists only 1-2 concrete actions; capabilities like diagram variety or export live only in the body. It fits anchor 3, not 4, because it does not list several specific actions.

3 / 5

Completeness

Both "what" ("Turn an idea, change or decision into a visual HTML canvas with Mermaid diagrams") and "when" (explicit "Trigger:" clause) are present. Scored 4 rather than 5 because the when-guidance is bare trigger keywords and lacks the situational criterion (">=3 moving parts") that only appears in the body, so it could be more explicit.

4 / 5

Trigger Term Quality

"Trigger: visualizá esto, canvas" includes one genuinely natural phrase (Spanish "visualizá esto") plus the generic keyword "canvas", but misses common variations and synonyms (English "visualize this", "diagram", "map this out", "draw"). Anchor 3 fits — relevant keywords present, common variants missing; not 2 because a real natural trigger phrase exists.

3 / 5

Distinctiveness Conflict Risk

"visual HTML canvas with Mermaid diagrams" carves a clear niche, but the bare trigger term "canvas" carries minor overlap risk with generic HTML-canvas or diagramming/dataviz skills. Mostly distinct with minor overlap — anchor 4.

4 / 5

Total

14

/

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

YoizenSA/dev-ai-workflow

Path

ywai/skills/visual-thinking/SKILL.md

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.