CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

figure-spec

Generate deterministic publication-quality architecture, workflow, and pipeline diagrams from structured JSON (FigureSpec) into editable SVG. Use when user says "架构图", "workflow 图", "pipeline 图", "确定性矢量图", "figure spec", "draw architecture", or needs precise, editable, publication-ready vector diagrams. Preferred over AI illustration for formal architecture/workflow figures.

Quality

79%

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/figure-spec/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

70%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 core workflow is excellent — clearly sequenced steps, validation-first rendering, explicit error-recovery loops, and a visual-review checklist, all with concrete commands. Weaknesses are concentrated in padded infrastructure prose (reviewer routing, tool-location resolver chain) and references to shared-references files that are not present in the bundle.

Suggestions

Move the reviewer-routing blockquote and the multi-layer $FIGURE_RENDERER resolver chain out of SKILL.md into a referenced file (or a script), trimming the Tool Location section to the three invoke commands plus one fallback line.

Remove internal changelog commentary ('Phase 3.1 (Arch C) move...') and the anecdotal '5 rounds ... C:7/R:7/S:8' report detail; they spend tokens without guiding the current task.

Verify or version the shared-references pointers (reviewer-backends.md, integration-contract.md, review-tracing.md) — they do not exist in this bundle; either ship them or inline the minimal needed contract so the skill is self-contained.

DimensionReasoningScore

Conciseness

The core workflow, schema tables, patterns, and anti-patterns are dense and efficient, but several sections are padded or tangential: the reviewer-routing blockquote at the top, the ~40-line multi-layer $FIGURE_RENDERER resolver chain, internal changelog commentary ('Phase 3.1 (Arch C) move...'), and the anecdotal 'ARIS tech report figures went through 5 rounds... C:7/R:7/S:8'. Mostly efficient but includes unnecessary sections that could be tightened or moved out.

3 / 5

Actionability

Highly concrete: exact resolver bash, invoke commands ('validate', 'render ... --output', 'schema'), rsvg-convert conversion, error categories to fix, and a visual-review checklist. The JSON templates contain literal '...' elisions (architecture template nodes, 'edges': [...]) so they are not fully copy-paste ready, matching anchor 4 rather than 5.

4 / 5

Workflow Clarity

Steps 1-5 are clearly sequenced with validation-first ordering ('Validate first'), an explicit error-recovery loop ('If validation fails, inspect the error ... and fix the JSON'), a visual-review checklist, and the rule 'edit the JSON spec (never the generated SVG) and re-render' — matching the anchor with explicit checkpoints, feedback loops, and a checklist.

5 / 5

Progressive Disclosure

The body correctly points to the real bundle file scripts/figure_renderer.py and defers the authoritative schema to the 'schema' command, but several references point to files absent from the bundle (../shared-references/reviewer-backends.md, shared-references/integration-contract.md, shared-references/review-tracing.md), these pointers are buried in dense prose, and heavyweight environment-resolution/reviewer-routing content that belongs in separate files is inlined.

3 / 5

Total

15

/

20

Passed

Description

83%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 strong description that clearly states what the skill does and when to use it, with bilingual trigger terms and explicit differentiation from AI illustration. Minor gaps: a few natural English synonyms are missing and generic diagram triggers could collide with lightweight flowchart skills.

DimensionReasoningScore

Specificity

The description names concrete capabilities — 'Generate deterministic publication-quality architecture, workflow, and pipeline diagrams from structured JSON (FigureSpec) into editable SVG' — but these are variations of a single generate action rather than multiple distinct concrete actions (extract/fill/merge/convert), so it falls just below the comprehensive anchor 5.

4 / 5

Completeness

Both 'what' ('Generate deterministic publication-quality architecture, workflow, and pipeline diagrams from structured JSON into editable SVG') and 'when' ('Use when user says "架构图", "workflow 图", ... or needs precise, editable, publication-ready vector diagrams') are explicit, with concrete trigger phrases matching anchor 5 exactly.

5 / 5

Trigger Term Quality

Good keyword coverage with concrete triggers users would say: '架构图', 'workflow 图', 'pipeline 图', 'figure spec', 'draw architecture'. Common natural variants like 'architecture diagram', 'system diagram', or plain 'diagram'/'SVG' are missing, keeping it below anchor 5.

4 / 5

Distinctiveness Conflict Risk

The niche (deterministic, editable, publication-ready vector diagrams from JSON) is distinct and it explicitly positions against alternatives ('Preferred over AI illustration for formal architecture/workflow figures'), but generic triggers like 'workflow 图'/'draw architecture' overlap with lighter diagram skills (e.g., mermaid-style flowcharts), so minor overlap risk remains.

4 / 5

Total

17

/

20

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.

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

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

Warning

relative_links

Relative link issues: 2 suspicious

Warning

Total

13

/

16

Passed

Repository

wanshuiyin/Auto-claude-code-research-in-sleep

Path

skills/figure-spec/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.