agentleFS
Hongyu-yuHongyu-yu/matsci-ai-skills/skills/pymatgen-io/SKILL.md

pymatgen-io

Skill19 starsChanged 10 months agoMITView on GitHub

Use for non-VASP input/output tasks in pymatgen.io: CIF/XYZ/Gaussian/OpenBabel and DFT/MD code IO such as CP2K, Q-Chem, ABINIT, LAMMPS, FEFF, NWChem, Quantum ESPRESSO, Wannier90, phonopy/shengbte, etc.

  • Installs packages

We split this skill into the rules it gives an agent

2 rules. About 0 are common, 2 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈2

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Ensure pymatgen is installed in your Python environment:

    line 16
  2. Distinctive:

    Write converted outputs or parse results.

    line 49

≈ “Common” is an estimate: at least 1 in 5 of the 308,232 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Pymatgen IO (Non-VASP)

Overview

Pymatgen IO (non-VASP) handles file formats and interfaces for many DFT/MD codes other than VASP.

Required Python Environment

Ensure pymatgen is installed in your Python environment:

pip install pymatgen
# or
conda install -c conda-forge pymatgen

Example usage pattern:

from pymatgen.io.cif import CifParser
# your code here

When to Use This Skill

  • Parse or write CIF, XYZ, Gaussian, or related formats
  • Interface with CP2K, QE, Q-Chem, ABINIT, LAMMPS, FEFF, NWChem, etc.

Core Capabilities

1. Common Formats

  • CIF, XYZ, Gaussian, and adapters (ASE/OpenBabel if installed)

2. Code Interfaces

  • Q-Chem, CP2K, Quantum ESPRESSO, ABINIT, LAMMPS, FEFF

3. Conversion

  • Convert external formats to Structure/Molecule

Quick Workflow

  1. Identify the input/output format or code interface.
  2. Parse into Structure or Molecule objects.
  3. Write converted outputs or parse results.

Resources

scripts/

Executable examples in the scripts/ directory:

  • 2013-01-01-Getting_crystal_structures_from_online_sources.py - Fetching structures from online sources and parsing formats.

references/

Detailed reference material (load as needed):

  • references/io-non-vasp.md - IO patterns and examples
  • references/docs/ - Local API docs for pymatgen.io

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

Reviews can't be read right now.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.