CtrlK
BlogDocsLog inGet started
Tessl Logo

figure-design-and-captioning

Design evidence-carrying figures and captions from research outputs, with reproducible script and data references.

52

Quality

58%

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 ./writing_skills/figure-design-and-captioning/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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 well-structured, lean instruction-only skill with a sensible claim-first workflow and useful caption/check guidance, weakened by dangling references to nonexistent `_references` files and by guidance that stays one notch above pseudocode — no example caption, output-path convention, or Output Contract format. Wiring the referenced files into the bundle and adding one worked example would lift it substantially.

Suggestions

Ship the two referenced files (`../_references/section-patterns-and-story.md` and `../_references/submission-and-editorial-readiness.md`) in the bundle, or remove/inline the links — currently they dangle.

Add a worked example: one sample caption filled into the 4-question template plus a concrete output-path and source-ref convention.

Define the Output Contract concretely (field names or a short template) instead of a bare list of items to return.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence — no explanation of what a figure or matplotlib is, every section carries operational content. It falls short of level 5 due to minor redundancy: three consecutive bullets in 'Figure selection rules' ('Do not use matplotlib...', 'Keep figure text sparse', 'Any explanation longer than a short phrase belongs in the caption') restate the same point, and the 'Suggested tools' list duplicates the frontmatter metadata block.

4 / 5

Actionability

The workflow names concrete tools ('use `generate_schematic_figure` with a precise prompt', 'use reproducible scripts or rendering tools, and keep the script path') and the caption template and image checks are specific, but there is no example caption, no concrete output-path convention, and the Output Contract is a bare noun list ('Return figure intent, output path, script path, source refs, and caption draft') with no format. This is more than level 2's high-level hints but lacks the completeness and copy-ready specificity of level 4.

3 / 5

Workflow Clarity

The six-step workflow is a clear claim-first sequence with an inspection checkpoint (step 5: 'Inspect the figure for readability, labeling, and whether the intended comparison is obvious') reinforced by a checks checklist. It misses level 5 because there is no explicit feedback loop — what to do when inspection fails or when data/paths are missing beyond the single 'do not invent figures' guard — and the checkpoint is implicit rather than a validate-and-retry cycle.

4 / 5

Progressive Disclosure

The body itself is well organized with clear sections, and the two references ('Read [../_references/section-patterns-and-story.md] for figure logic', 'Read [../_references/submission-and-editorial-readiness.md] before finalizing legends') are clearly signaled and purpose-annotated. However, the referenced files do not exist in the bundle — there is no `_references/`, `references/`, `scripts/`, or `assets/` directory — so the navigation structure is broken at the exact point it delegates detail, which the guideline to score against the actual bundle structure penalizes. It stays above level 2 because the inline content is well sectioned and references are clearly signaled, not buried.

3 / 5

Total

14

/

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 is concise, third-person, and clearly communicates what the skill does, but it omits any 'Use when...' trigger guidance and lacks natural synonym coverage (plot, chart, graph, schematic). Adding an explicit trigger clause and a couple of user-natural terms would raise completeness and trigger quality without added length.

Suggestions

Append a trigger clause, e.g. 'Use when a manuscript section needs figures, plots, schematics, or captions derived from computational results.'

Add natural synonyms users would actually say — 'figure', 'plot', 'chart', 'schematic', 'caption' — and drop the authorial phrase 'evidence-carrying'.

Mention the figure types the skill covers (schematics, comparison plots, tables) to sharpen distinctiveness against generic charting skills.

DimensionReasoningScore

Specificity

"Design evidence-carrying figures and captions from research outputs, with reproducible script and data references" names the domain (manuscript figures/captions) and two concrete actions (design figures, write captions) plus provenance tracking, but stops short of the comprehensive multi-action enumeration of the 4–5 anchors. It is above level 2 because the actions are specific rather than generic ('Processes PDF files'), but below level 4 because only the two core actions are covered without coverage of the skill's other capabilities (schematics, tables, rendering checks).

3 / 5

Completeness

The 'what' is clearly stated (design figures and captions with script/data provenance), but there is no 'Use when...' clause or equivalent trigger guidance, which the guidelines say caps completeness at 3. It does not reach level 4 because the 'when' is entirely absent rather than merely under-specified.

3 / 5

Trigger Term Quality

Relevant keywords like "figures", "captions", and "research outputs" are present, but common natural variations users would say — "plot", "chart", "schematic", "graph", "table", "paper figure" — are missing, and "evidence-carrying" is authorial phrasing no user would utter. It beats level 2 ('one or two generic keywords') on relevance but lacks the synonym coverage of level 4.

3 / 5

Distinctiveness Conflict Risk

The combination of figures + captions + reproducible script/data references carves a fairly clear manuscript-figure niche with distinct triggers, with only minor overlap risk against generic plotting or dataviz skills. It does not reach level 5 because terms like 'figures' and 'captions' alone could still plausibly match adjacent charting or document-formatting skills.

4 / 5

Total

13

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

relative_links

Relative link issues: 2 suspicious

Warning

Total

14

/

16

Passed

Repository
fernandezbaptiste/CatMaster
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.