CtrlK
BlogDocsLog inGet started
Tessl Logo

materials-discovery-and-bulk-selection

Use this skill for materials discovery and bulk structure selection before slab construction, including database query strategy, candidate filtering, and export readiness.

61

Quality

73%

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/materials-discovery-and-bulk-selection/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

71%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 a lean, well-sequenced, tool-aware workflow with genuine validation checkpoints (preview inspection, results/errors checking for partial downloads). Its main weakness is actionability: it never shows an example search query, criteria set, or field list, so the executor must invent the most error-prone step, and there is no recovery loop for failed downloads.

Suggestions

Add a concrete example `mp_search_materials` invocation (sample criteria and requested fields) so the 'search with explicit criteria' step is executable rather than aspirational.

Add an error-recovery feedback loop for the batch download step: when `errors` is non-empty, retry failed `mp_id` values or trim them from the shortlist before reporting.

Fold the 'Suggested tools' list and the Quick Start steps into the Workflow to remove duplication with the frontmatter metadata and tighten the token budget.

DimensionReasoningScore

Conciseness

The ~40-line body is efficient and tool-specific (e.g. "writes the full result table to `output_csv_rel` and returns preview rows") with no concept explanations Claude already knows. Not 5 because Quick Start restates the Workflow sequence and "Suggested tools" duplicates the frontmatter metadata — minor trimmable redundancy.

4 / 5

Actionability

Quotes: "Use `mp_search_materials` to write a CSV candidate table", "`mp_download_structure` writes conventional standard structures under `output_dir`" — concrete tool names, parameters, and behaviors are given, but there is no example query, criteria set, or field list; "Define search criteria and requested fields" is a high-level hint without executable specifics, matching anchor 3 (concrete guidance but missing key details).

3 / 5

Workflow Clarity

The three steps (search with explicit criteria → prune before download → download retained candidates) are clearly sequenced, and validation checkpoints exist ("returns preview rows for quick inspection", "Use the returned `results` and `errors` rather than assuming every requested ID resolved"), so the batch-operation cap at 3 does not bind. Not 5 because there is no error-recovery feedback loop (e.g. retry or trim failed IDs) for the batch download step.

4 / 5

Progressive Disclosure

The skill is under 50 lines, needs no external references (no references/, scripts/, or assets/ bundles exist), and is organized into clear sections (Overview, Quick Start, Suggested tools, Workflow, Output Contract, References). Per the rubric's simple-skill guidance, well-organized sections alone merit a 5; the References section is a pointer to the tool schema, not a broken file reference.

5 / 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.

The description is specific, domain-grounded, and includes an explicit use-trigger with a clear pre-slab-construction boundary. Its main gaps are missing user-facing trigger variations (Materials Project, screening, structure download) and a 'when' clause that names a pipeline stage rather than concrete user requests.

DimensionReasoningScore

Specificity

Quotes: "materials discovery and bulk structure selection before slab construction", "database query strategy, candidate filtering, and export readiness" — several specific activities are named, matching anchor 4. Not 3 because more than 1-2 concrete actions are listed; not 5 because downstream actions (shortlisting, structure download) are not enumerated.

4 / 5

Completeness

Quotes: "Use this skill for materials discovery and bulk structure selection... including database query strategy, candidate filtering, and export readiness" — the 'what' is clear and multi-part, and an explicit 'Use this skill for...' trigger clause with a 'before slab construction' condition provides the 'when'. Not 5 because the 'when' is not framed as concrete user-trigger phrases (e.g. 'when the user asks to find bulk structures').

4 / 5

Trigger Term Quality

Quotes: "materials discovery", "bulk structure selection", "slab construction", "candidate filtering" — good natural keyword coverage for the domain, but common variations users might say (e.g. "Materials Project", "screening", "download structures") are missing, so anchor 4 rather than 5.

4 / 5

Distinctiveness Conflict Risk

Quotes: "bulk structure selection before slab construction" — a clear niche with distinct domain triggers and an explicit boundary ('before slab construction'). Not 5 because "materials discovery" is broad enough to risk minor overlap with adjacent materials-science or structure-download 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_version

'metadata.version' is missing

Warning

Total

15

/

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.