CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

structure-visual-inspection

Use this skill when a task needs visual inspection of atomic structures, adsorption geometries, slab-site context, or image-based sanity checks before or alongside numerical analysis.

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 ./skills/structure-visual-inspection/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

78%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 skill: a clear workflow with decision gates and verification rules, a useful output contract, and honest guardrails separating visual evidence from numerical confirmation. Its only weaknesses are mild redundancy between Quick Start and the Workflow/defaults sections and the lack of any example tool invocation.

Suggestions

Drop the redundant Quick Start items that restate the Workflow and Method-critical defaults (visual findings as supporting evidence, confirming claims numerically) so each rule appears once.

Add one example invocation of render_structure_views (with the default view set) and analyze_images (with a narrow-question prompt) to close the actionability gap.

DimensionReasoningScore

Conciseness

The body is lean with no explanation of concepts Claude already knows, but there is minor redundancy: Quick Start items 3-4 ("Treat visual findings as supporting evidence", "Confirm critical geometric claims with numerical tools") restate the Workflow's "hand back to numerical geometry tools" and the Method-critical defaults. Efficient with minor trims possible, one notch below every-token-earns-its-place.

4 / 5

Actionability

Concrete, executable guidance for an instruction-only skill: named tools ("render_structure_views", "analyze_images"), specific values ("typical slab retries are (2,2,1) or (3,3,1)"), and a concrete output contract ("Return the main panel image path"). The minor gap keeping it below fully copy-paste-ready is the absence of any example tool invocation or argument syntax.

4 / 5

Workflow Clarity

A clear five-step sequence with explicit decision gates ("only call image analysis when the visual question is still ambiguous") and verification checkpoints ("verify it with file-based structures or numeric geometry analysis before changing the workflow"). It falls short of the top anchor only because there is no recovery path when a render is unreadable or ambiguous after retries.

4 / 5

Progressive Disclosure

The skill is under 50 lines, has no bundle files (references/, scripts/, assets/ are absent), and needs no external references — the simple-skill exception applies. Sections are well-organized and easy to navigate, with no inlined content that belongs in separate files.

5 / 5

Total

17

/

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 has an explicit, well-scoped trigger clause and a distinctive domain niche, but it is entirely 'when' with no independently stated 'what' — the skill's concrete capabilities (rendering structure views, running image analysis) are never named. Trigger coverage is decent domain jargon but misses the natural phrasings a user would actually say.

Suggestions

Split into a 'what' plus a trigger: e.g., "Renders four-view structure panels and runs targeted image analysis for atomic structures and adsorption geometries. Use when visually inspecting a slab, checking adsorption sites, or sanity-checking a structure before/alongside numerical analysis."

Add natural trigger synonyms users would say: "view/render the structure", "adsorption site", "surface/slab model", and relevant file extensions (.xyz, .cif, .traj) if applicable.

State the concrete deliverable in the description (e.g., returns panel image paths and an obvious/tentative/needs-numerical-confirmation verdict) so the 'what' is explicit, not implied.

DimensionReasoningScore

Specificity

Phrases like "visual inspection of atomic structures" and "image-based sanity checks" name the domain with one or two actions, but the description never states what the skill actually does (rendering four-view panels, running targeted image analysis). This matches the anchor for naming the domain with 1-2 concrete actions without comprehensive coverage.

3 / 5

Completeness

The 'when' is explicit ("Use this skill when a task needs visual inspection..."), but the 'what' is only weakly implied through that trigger clause — rendering structure views and image analysis capabilities are never stated as actions the skill performs. It is the mirror image of a clear 'what' with a weakly implied 'when', so it sits at the middle anchor rather than the both-present anchor above.

3 / 5

Trigger Term Quality

Relevant domain keywords are present ("atomic structures", "adsorption geometries", "slab-site context"), but common variations a user would naturally say are missing ("view/render the structure", "surface model", "before/after relaxation", file extensions). Some relevant keywords without the variations maps to the middle anchor, not the good-coverage anchor above it.

3 / 5

Distinctiveness Conflict Risk

Triggers like "adsorption geometries", "slab-site context", and "atomic structures" define a clear computational-materials niche, but "image-based sanity checks" could overlap with a general image-analysis skill. Mostly distinct with minor overlap risk, falling short of the minimal-conflict anchor.

4 / 5

Total

13

/

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_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository

fernandezbaptiste/CatMaster

Path

skills/structure-visual-inspection/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.