CtrlK
BlogDocsLog inGet started
Tessl Logo

publication-chart-skill

This skill should be used when the user asks for a publication-quality scientific figure or table, wants help choosing the right chart for results, needs a paper-ready pubfig or pubtab workflow, wants a figure + companion table for a results section, wants an Excel sheet turned into publication-ready LaTeX, or wants an existing scientific figure/table reviewed and upgraded.

62

Quality

74%

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/publication-chart-skill/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

73%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, workflow-driven skill body with explicit sequencing, validation checkpoints, and strong progressive disclosure into a verified bundle of executable recipe files. Its weaknesses are redundancy (duplicated install guidance and three overlapping output-contract sections) and a dangling 'examples/' reference.

Suggestions

Merge 'Missing dependency behavior' into step 0 and collapse 'Define the delivery contract', 'Output style rules', and 'Recommended response shape' into a single section to remove the duplicated install commands and overlapping output guidance.

Remove or fix the 'For prompt-shaped examples, see examples/' pointer — the directory does not exist in the bundle.

Inline one minimal runnable pubfig snippet (fig = pf.line(...); pf.save_figure(fig, 'figure1.pdf')) in step 4 so the primary generation route is copy-paste ready without leaving the main file.

DimensionReasoningScore

Conciseness

The body does not explain concepts Claude already knows, but it is noticeably redundant: the install command list appears in full twice (step 0 and 'Missing dependency behavior'), and three sections — 'Define the delivery contract', 'Output style rules', and 'Recommended response shape' — restate overlapping output guidance. This fits anchor 3 (mostly efficient, could be tightened) rather than anchor 4, whose 'minor instances' understate this level of duplication.

3 / 5

Actionability

Environment probing, install fallbacks, and route selection are fully executable ('python3 scripts/ensure_publication_tooling.py --require pubfig --json', 'uv pip install pubfig'), and the runnable artifact code lives in well-mapped reference files. However, the body itself never shows a runnable snippet for the primary generation task — 'one pubfig call + one save_figure(...)' and 'batch_export(...)' are named but never demonstrated — leaving minor gaps versus anchor 5's copy-paste-ready coverage of common cases.

4 / 5

Workflow Clarity

The workflow is an explicitly numbered 8-step sequence (0-7) with validation checkpoints throughout: probe → auto-install → re-probe → continue/degrade, an evidence-contract gate ('Do not create a paper-ready plot while the unit of analysis, missing-cell handling, or error-bar basis is unresolved'), a concrete QA step, and a revise loop with specific falsifiable changes. This matches anchor 5's explicit validation, feedback loops, and checklists.

5 / 5

Progressive Disclosure

The body is a genuine overview with a well-annotated Resources section pointing to 13 one-level-deep files, all of which exist in the bundle (references/, scripts/, source-guides/ verified on disk). It falls short of anchor 5 because the closing pointer 'For prompt-shaped examples, see examples/' references a directory that does not exist in the bundle, a dangling navigation link.

4 / 5

Total

16

/

20

Passed

Description

75%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, trigger-rich description with concrete, natural-sounding scenarios and a well-defined publication niche. Its main weakness is that the 'what' is only implicit inside when-clauses and never stated as a direct capability statement, and a few natural synonyms (plot, graph, .xlsx) are absent.

Suggestions

Open with a direct third-person capability statement (e.g. 'Creates publication-grade scientific figures and tables from research results via pubfig and pubtab') before the trigger list, so the 'what' is explicit rather than implied by when-clauses.

Add common natural trigger terms such as 'plot', 'graph', and '.xlsx' that users say when asking for publication visuals from spreadsheet data.

DimensionReasoningScore

Specificity

The description enumerates several concrete capabilities — 'choosing the right chart for results', 'figure + companion table for a results section', 'Excel sheet turned into publication-ready LaTeX', 'reviewed and upgraded' — with minor gaps (it never states the core generate/export/QA actions as capabilities). It lists several specific actions with minor coverage gaps, matching anchor 4 rather than anchor 3 (which expects only 1-2 actions) or anchor 5 (comprehensive action coverage including export and QA).

4 / 5

Completeness

The 'when' is explicit and concrete ('This skill should be used when the user asks for...') with six trigger scenarios, and the 'what' is present but embedded inside the when-clauses ('paper-ready pubfig or pubtab workflow', 'publication-ready LaTeX') rather than stated as a standalone capability sentence. This matches anchor 4 (both present, one could be more explicit) rather than anchor 5 (both clearly and separately stated).

4 / 5

Trigger Term Quality

Natural user phrases are present: 'publication-quality scientific figure', 'paper-ready', 'Excel sheet', 'LaTeX', 'results section', 'companion table'. A few common terms users would naturally say are missing ('plot my results', 'graph', '.xlsx'), so it fits anchor 4 rather than the comprehensive synonym/extension coverage of anchor 5, but is well above anchor 3's 'missing common variations'.

4 / 5

Distinctiveness Conflict Risk

A clear niche (publication-grade scientific figures and tables via pubfig/pubtab, Excel-to-LaTeX conversion) with distinct trigger vocabulary that generic dataviz or document skills would not claim. Minor overlap risk with general chart-creation skills keeps it at anchor 4 rather than anchor 5's minimal-conflict profile.

4 / 5

Total

16

/

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

frontmatter_unknown_keys

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

Warning

referenced_paths_exist

Referenced path issues: 6 deeper-than-1-level

Warning

Total

14

/

16

Passed

Repository
Galaxy-Dawn/claude-scholar
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.