pymatgen
by K-Dense-AIpymatgen is a Python materials science toolkit for crystal structures, phase diagrams, electronic structure, and file conversion. This pymatgen skill helps with scientific workflows using CIF, POSCAR, VASP, and Materials Project data.
This skill scores 84/100, which means it is a solid listing candidate for Agent Skills Finder. It gives directory users enough evidence to understand what it covers, when to trigger it, and why it offers more leverage than a generic prompt, though it would still benefit from more executable setup detail and supporting files.
- Strong triggerability: the skill explicitly lists use cases such as structure conversion, phase diagrams, band structures, Materials Project access, and workflow setup.
- Good operational depth: the body is substantial, with many headings and workflow-oriented sections rather than placeholder content.
- High agent leverage for materials-science tasks: it names specific formats, analyses, and codes (CIF, POSCAR, VASP, Gaussian, Quantum ESPRESSO) that help an agent choose the right path quickly.
- No install command is present in SKILL.md, so users may need to infer setup rather than follow a ready-made installation path.
- The repository appears to contain only the skill file, with no scripts, references, rules, or assets, which limits external verification and support material.
Overview of pymatgen skill
What pymatgen is for
pymatgen is a Python materials science toolkit for working with crystal structures, phase stability, electronic structure, and file conversion. The pymatgen skill is most useful when you need to turn raw computational materials data into something you can inspect, compare, or automate across many structures.
Who should use it
Use the pymatgen skill if you are doing computational materials science, solid-state chemistry, or high-throughput workflows with formats like CIF, POSCAR, XYZ, or outputs from VASP and related tools. It is a strong fit for researchers who need reliable structure handling more than a generic Python prompt.
What makes it different
The main value of pymatgen is breadth plus domain logic: it does not just parse files, it helps you reason about symmetry, thermodynamics, band structures, density of states, surfaces, interfaces, and Materials Project data. That makes the pymatgen guide better suited to scientific work than general-purpose code generation.
How to Use pymatgen skill
Install pymatgen cleanly
For local use, install the package with uv pip install pymatgen. If you need Materials Project access, install the API client extra or the matching dependency set used by your environment. Before you start, confirm your Python version and whether your workflow depends on NumPy, pandas, or plotting libraries already present in your stack.
Turn a rough goal into a usable prompt
A weak request like “analyze this structure” usually leads to generic output. A better pymatgen usage prompt names the input format, the target calculation, and the expected output. For example: “Read a CIF, compare symmetry before and after relaxation, then export a POSCAR and summarize band gap and stability assumptions.”
Read the right files first
Start with SKILL.md to understand the scope, then inspect the quick-start and installation sections in the repository copy before adapting anything. If you are using pymatgen for Scientific workflows, prioritize the examples that match your task: file conversion, phase diagram analysis, Materials Project queries, or structure generation. Do not assume one example covers all analysis paths.
Workflow tips that matter
Give the skill the exact structure type, source code, and desired artifact. State whether you need a script, a notebook cell, or a one-off analysis. If you care about reproducibility, specify composition, oxidation states, unit conventions, and whether outputs should be normalized. These details reduce silent mistakes in pymatgen usage, especially when comparing structures from different codes.
pymatgen skill FAQ
Is pymatgen a good fit for my task?
Yes if your job involves structure parsing, symmetry analysis, thermodynamics, or Materials Project data. It is not the best choice for purely general Python automation or for tasks that do not involve materials data. If your prompt has no structure files, no chemistry context, and no scientific output requirement, the skill is probably unnecessary.
How does this compare with a generic prompt?
A generic prompt may produce plausible code, but the pymatgen skill gives you a more specific materials-science path and better expectations about formats, workflows, and outputs. That matters when file conversion or stability analysis needs to be correct rather than merely syntactically valid.
Is pymatgen beginner friendly?
It is usable for beginners, but only if you can name the input and the goal clearly. Beginners usually struggle when they ask for “best practice” without supplying a file type, a target property, or a desired export format. The pymatgen guide works best when you start with a narrow task.
When should I not use it?
Do not reach for pymatgen skill if you only need a simple chemistry calculator, a plotting helper, or a non-scientific text transformation. Also avoid it when the workflow depends on another domain package that already owns the task end to end. The skill is strongest when the problem is explicitly pymatgen-shaped.
How to Improve pymatgen skill
Give complete scientific context
The biggest quality gain comes from naming the material system, source format, and intended analysis. Say whether the structure is relaxed or experimental, whether composition should be preserved, and whether you need comparison against reference phases or only a file conversion. This is especially important in pymatgen for Scientific use cases.
Specify the exact deliverable
Ask for the artifact you actually need: Python script, notebook snippet, CLI workflow, table, or serialized structure. If you want code, include the expected input path and output file. If you want analysis, specify the metrics: formation energy, convex hull distance, band gap, coordination environments, or symmetry group.
Reduce ambiguity in the first pass
Common failure modes are missing oxidation states, mixed units, unclear boundary conditions, and unstated library versions. If a result depends on Materials Project access, say so up front. If you need compatibility with VASP, Quantum ESPRESSO, or another code, name the target format explicitly so the pymatgen skill can choose the right conversion path.
Iterate with a tighter second request
If the first output is close but not usable, keep the same structure data and refine only one variable at a time: format, property, or downstream code target. That makes it easier to correct pymatgen usage without reintroducing new errors.