CtrlK
BlogDocsLog inGet started
Tessl Logo

scientific-schematics

Create publication-quality scientific diagrams using Nano Banana 2 AI with smart iterative refinement. Uses Gemini 3.6 Flash for quality review. Only regenerates if quality is below threshold for your document type. Specialized in neural network architectures, system diagrams, flowcharts, biological pathways, and complex scientific visualizations.

61

Quality

72%

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 ./.claude/skills/scientific-schematics/SKILL.md

The canonical home for this skill is scientific-schematics in K-Dense-AI/scientific-agent-skills

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.

The body is highly actionable with an unusually strong verification story — executable commands, exact error strings, a review-log contract, and honest limitations ('What the pipeline cannot do'). Its weakness is structural redundancy: the same usage command and API-key setup appear three to four times across redundant sections, inflating token cost without adding information. Consolidating the repeated quick-start/environment sections would bring conciseness in line with the rest of the skill's quality.

Suggestions

Collapse 'Quick Start', 'How to Use This Skill', 'Command-Line Usage', and 'Getting Started' into one usage section; the command 'python scripts/generate_schematic.py "..." -o output.png' currently appears four times.

Merge 'Configuration' and 'Environment Setup' — both just export OPENROUTER_API_KEY and link to the same keys page.

Move the long 'Quick Reference Checklist' and 'Integration Guidelines' sections into references/best_practices.md, keeping only a pointer, to cut the 370-line body down toward an overview.

DimensionReasoningScore

Conciseness

The 370-line body repeats the same basic command four times across 'Quick Start', 'How to Use This Skill', 'Command-Line Usage', and 'Getting Started', and duplicates the OPENROUTER_API_KEY export in both 'Configuration' and 'Environment Setup', plus marketing padding ('✅ Saves API calls', '**That's it!**'). This matches anchor 2 — several unnecessary or padded sections — rather than 3, where redundancy would be occasional rather than structural.

2 / 5

Actionability

Commands are copy-paste ready with real flags and doc-types ('python scripts/generate_schematic.py "..." -o figures/consort.png --doc-type journal'), troubleshooting quotes exact error strings with fixes ('Error: requests library not found' → 'uv pip install requests'), and log fields are named precisely ('"score": null', '"reviewed": false', '"critique"'). Specific examples cover the common cases, matching anchor 5.

5 / 5

Workflow Clarity

The generate-review-refine loop is sequenced 1–5 with explicit stop criteria, threshold semantics per doc-type, a spelled-out fallback when review fails, and a thorough verification checklist (review log, inspect image, accessibility, publication fit). This matches anchor 5's explicit validation and error-recovery guidance; not a destructive/batch skill, so no cap applies.

5 / 5

Progressive Disclosure

Two real, one-level-deep references (references/iterative_refinement.md, references/best_practices.md) are clearly signaled with descriptions of what each contains, and the heavy loop/API/examples material is correctly split out. Not 5: at 370 lines the SKILL.md still inlines large checklist, best-practices, and troubleshooting sections that partially duplicate the reference files and could be moved or trimmed.

4 / 5

Total

16

/

20

Passed

Description

71%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 specific, well-scoped description with concrete actions and strong natural keywords, but it never tells Claude when to invoke it. Adding an explicit 'Use when...' clause (e.g., when the user needs a scientific figure, schematic, or architecture diagram for a paper, poster, or talk) would raise both completeness and trigger coverage. Mentioning 'schematic' and 'figure' as trigger terms would further reduce conflict risk with generic visualization skills.

Suggestions

Add an explicit trigger clause, e.g.: 'Use when the user needs a scientific figure, schematic, or diagram (neural network architecture, system/block diagram, flowchart, biological pathway) for a paper, thesis, poster, or presentation.'

Include the natural synonyms users actually say — 'schematic', 'figure', 'model diagram' — in the trigger keywords alongside the existing specialization list.

Trim implementation detail ('Uses Gemini 3.6 Flash for quality review') in favor of when-to-use guidance; the reviewer model is invisible to the user choosing a skill.

DimensionReasoningScore

Specificity

The description names the domain and multiple concrete actions — 'Create publication-quality scientific diagrams', 'Uses Gemini 3.6 Flash for quality review', 'Only regenerates if quality is below threshold' — plus a five-item specialization list (neural network architectures, system diagrams, flowcharts, biological pathways, complex scientific visualizations), giving comprehensive coverage. It exceeds anchor 4 because the action list and diagram-type coverage are broad rather than having only minor gaps.

5 / 5

Completeness

The 'what' is clear (create publication-quality scientific diagrams with AI generation and quality review), but there is no 'Use when...' clause or equivalent explicit trigger guidance; 'Specialized in...' is a capability statement, not a trigger. Per the rubric, a missing 'Use when...' clause caps completeness at 3; it is not 2 because the 'what' is fully concrete.

3 / 5

Trigger Term Quality

Good natural keyword coverage: 'scientific diagrams', 'neural network architectures', 'system diagrams', 'flowcharts', 'biological pathways', 'publication-quality'. Not 5 because common synonyms users would say are missing — 'schematic', 'figure', and phrases like 'diagram for my paper' — leaving a few natural terms absent.

4 / 5

Distinctiveness Conflict Risk

The scientific-diagram niche with specific types (neural network architectures, biological pathways, CONSORT-style flowcharts) is mostly distinct from other skills. Not 5 because 'complex scientific visualizations' has minor overlap risk with general data-visualization/plotting skills.

4 / 5

Total

16

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_field

'metadata' should map string keys to string values

Warning

Total

15

/

16

Passed

Repository
K-Dense-AI/claude-scientific-writer
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.