CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

Quality

70%

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

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.

The body is a tight, well-structured instruction skill: it documents exact tool contracts and failure modes, sequences the workflow clearly with verification checkpoints, and avoids teaching concepts Claude already knows. The only real gaps are mild Quick Start/Workflow duplication and the absence of a worked example of search criteria and fields.

DimensionReasoningScore

Conciseness

The body is lean (~40 lines), assumes Claude's competence, and conveys non-obvious operational facts (tool failure conditions, parameter names, partial-success behavior) rather than explaining known concepts. Minor trimmable redundancy keeps it from anchor 5: the Quick Start steps substantially duplicate the Workflow section (e.g. 'Prune the candidate table before downloading structures' vs '### 2. Prune before download'), and the single-sentence Overview restates the frontmatter description.

4 / 5

Actionability

Guidance is concrete for an instruction-only skill: named tools (`mp_search_materials`, `mp_download_structure`), named parameters/outputs (`output_csv_rel`, `output_dir`, `mp_id`), and specific behavioral contracts ('fails on empty criteria or empty fields', 'supports partial success', 'use the returned results and errors'). It falls short of anchor 5 because no concrete example of search criteria or a requested-fields set is given — 'Define search criteria and requested fields' and the References note defer to the tool schema instead of showing a worked case.

4 / 5

Workflow Clarity

A clear three-step sequence (search with explicit criteria → prune via the CSV ledger → download only retained candidates) with verification checkpoints present: inspect preview rows, check returned results/errors rather than assuming success, and report partial-download failures in the Output Contract. Anchor 5 is not reached because the error-recovery loop is thin — failures are flagged for 'follow-up' but no retry/fix guidance is given for the batch download step.

4 / 5

Progressive Disclosure

The skill is under 50 lines with no bundle files (references/, scripts/, assets/ do not exist) and no external references are needed; the rubric's simple-skill exception applies and the well-organized sections (Overview, Quick Start, Suggested tools, Workflow, Output Contract, References) earn a 5. The References section is a behavioral pointer to the live tool schema, not a file reference, so there are no broken or deeply-nested reference paths.

5 / 5

Total

17

/

20

Passed

Description

48%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 correctly delimits a niche domain and avoids fluff, but it describes scope areas as abstract nouns rather than concrete capabilities and omits the pivotal 'Materials Project' entity. It lacks an explicit 'Use when...' trigger clause, capping completeness, and its imperative 'Use this skill for...' framing is not the third-person voice the rubric expects.

Suggestions

Rewrite the 'what' in third person with concrete verbs, e.g. 'Queries Materials Project for candidate materials, filters the results into a shortlist, and downloads conventional bulk structures ready for slab construction.'

Add an explicit trigger clause with natural user phrasing: 'Use when the user asks to find, screen, or download bulk materials/structures before building slabs for surface or catalysis calculations.'

Include the database name 'Materials Project' (and synonyms like MP, materials screening, candidate shortlisting) so the description matches what users actually say.

DimensionReasoningScore

Specificity

The description names the domain ("materials discovery and bulk structure selection before slab construction") and lists action areas ("database query strategy, candidate filtering, and export readiness"), but these are abstract noun phrases rather than concrete verb-driven actions, and the actual capabilities (querying Materials Project, downloading structures) are never stated. Base fit was anchor 3; the 'what' is delivered in second-person imperative voice ("Use this skill for...") rather than third person, which the rubric penalizes by 1, landing at 2.

2 / 5

Completeness

The 'what' is present ("materials discovery and bulk structure selection... database query strategy, candidate filtering, and export readiness") though abstractly phrased. The 'when' is only weakly implied by the workflow-position phrase "before slab construction"; there is no explicit 'Use when...' clause or equivalent user-situation trigger, which the guidelines cap at 3. Not anchor 4 because the when-guidance is a pipeline stage, not a trigger condition a user would surface.

3 / 5

Trigger Term Quality

Some relevant domain keywords are present ("materials discovery", "bulk structure selection", "slab construction"), but major natural terms are missing: the central database name "Materials Project"/"MP", "download structures", and common synonyms like "screening" or "candidate shortlisting". This matches 'some relevant keywords but missing common variations or synonyms' rather than anchor 4's fuller coverage.

3 / 5

Distinctiveness Conflict Risk

The niche is clear and specific — pre-slab-construction bulk materials selection in a catalysis/surface-modeling context — with distinct terms like "slab construction" and "bulk structure selection". It sits between anchor 4 and 5: mostly distinct with only minor overlap risk against a hypothetical generic structure-download or slab-construction skill, but the trigger set is not rich enough for anchor 5's 'clear niche with distinct triggers' exemplar.

4 / 5

Total

12

/

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/materials-discovery-and-bulk-selection/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.