CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

pymatgen

Materials science toolkit. Crystal structures (CIF, POSCAR), phase diagrams, band structure, DOS, Materials Project integration, format conversion, for computational materials science.

56

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 ./backend/cli/skills/physics/pymatgen/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

61%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 dense, highly actionable reference body with excellent executable examples, real and well-signaled bundle files, and clear multi-step workflows. Its weaknesses are the absence of explicit validation/feedback loops in the batch and multi-step workflows (capping workflow clarity), and padding — the overview, when-to-use, and generic best-practices sections could be trimmed to save context tokens.

Suggestions

Add explicit validation checkpoints to the multi-step workflows, e.g. after relaxation check `Vasprun(...).converged` before generating the static/NSCF inputs, and validate converted structures (space group / lattice match) in the batch conversion and doping loops.

Trim the Overview paragraph and 'When to Use This Skill' list (they restate the frontmatter description), and replace generic best-practice bullets with a pointer to a reference file.

Move the per-capability code deep-dives (e.g. surfaces, advanced analysis) into the existing references, keeping only one compact example per capability in SKILL.md to reduce token load.

DimensionReasoningScore

Conciseness

The body is mostly code (good), but the ~700-line length includes padding Claude doesn't need: an Overview paragraph that largely restates the description ("Pymatgen is a comprehensive Python library for materials analysis that powers the Materials Project"), a 'When to Use This Skill' section that duplicates the description's job, and generic best-practice platitudes ("Check convergence: Always verify calculations converged", "Organize calculations: Use clear directory structures"). This fits 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than the 'minor instances' of anchor 4.

3 / 5

Actionability

Nearly all guidance is executable: copy-paste Python with imports (Structure.from_file, SpacegroupAnalyzer, MPRester, MPRelaxSet) and concrete script invocations ("python scripts/structure_converter.py POSCAR structure.cif"). Not a 5 because a few snippets reference undefined variables — e.g. "ElasticTensor.from_voigt(matrix)", "len(bulk) * bulk_E_per_atom", and the Gaussian example's undefined "mol" — leaving minor gaps.

4 / 5

Workflow Clarity

Multi-step workflows are clearly numbered (band structure: relax → static → NSCF → analysis; surface energy: bulk → slabs → calculation), but none include explicit validation checkpoints or error-recovery loops — convergence is only mentioned as generic advice. Per the rubric, batch operations without validation (the doped-structure generation loop, batch file conversion) cap workflow_clarity at 3.

3 / 5

Progressive Disclosure

The bundle is well structured: each capability section ends with a clearly signaled, one-level-deep pointer ("See `references/core_classes.md`", "See `references/analysis_modules.md` (Phase Diagrams section)"), and a 'Bundled Resources' section inventories all 5 reference files and 3 scripts — all of which exist and are substantial. Not a 5 because the SKILL.md itself inlines substantial per-capability detail (9 capability sections plus 3 workflows) that could partly live in the references it already ships.

4 / 5

Total

14

/

20

Passed

Description

70%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, keyword-rich description that clearly conveys what the skill does and is well differentiated from other skills. Its main weakness is the complete absence of an explicit 'Use when...' trigger clause, which caps completeness and weakens discoverability against natural user phrasing.

Suggestions

Append an explicit trigger clause, e.g. "Use when working with crystal structure files (CIF, POSCAR, .xyz), computing phase diagrams or thermodynamic stability, analyzing band structure/DOS, or querying the Materials Project database."

Add common user phrasings and synonyms such as "space group", "slab/surface generation", "VASP input files", and "DFT" to broaden natural trigger coverage.

DimensionReasoningScore

Specificity

The description lists several concrete capabilities — "Crystal structures (CIF, POSCAR), phase diagrams, band structure, DOS, Materials Project integration, format conversion" — with format names included, matching the 'several specific actions; minor gaps in coverage' anchor. It falls short of 5 because capabilities are stated as noun fragments rather than fully enumerated actions, and areas like symmetry analysis, surfaces, and VASP input generation (covered in the body) are absent.

4 / 5

Completeness

The 'what' is clear and specific, but there is no "Use when..." clause or equivalent explicit trigger guidance — only the weakly implied "for computational materials science." Per the judging guidelines, a missing 'Use when' clause caps completeness at 3. It is not a 4 because the 'when' is absent, not merely underspecified.

3 / 5

Trigger Term Quality

Strong domain keywords users would naturally say: "Materials science", "Crystal structures", "CIF, POSCAR", "phase diagrams", "band structure", "DOS", "Materials Project", "format conversion". Not a 5 because common variations and synonyms are missing (e.g., "space group", "VASP", "DFT", "structure files", "slab/surface").

4 / 5

Distinctiveness Conflict Risk

The description carves out a clear niche — computational materials science with pymatgen-specific artifacts (CIF/POSCAR, Materials Project, band structure/DOS) — that no generic toolkit description would overlap. Distinct triggers like "Materials Project" and "POSCAR" make wrong-skill triggering very unlikely.

5 / 5

Total

16

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (697 lines); consider splitting into references/ and linking

Warning

metadata_version

'metadata.version' is missing

Warning

frontmatter_unknown_keys

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

Warning

Total

13

/

16

Passed

Repository

synthetic-sciences/openscience

Path

backend/cli/skills/physics/pymatgen/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.