Agent skill

Mat Solid Free Energy

by learningmatter-mit in learningmatter-mit/AtomisticSkills

Calculate absolute solid Helmholtz free energy, and optional Gibbs free energy, with Frenkel-Ladd switching using portable MLIP wrappers on a pre-equilibrated periodic structure.

MITAuto-check passed

Install Mat Solid Free Energy

skills CLI
$ npx skills add learningmatter-mit/AtomisticSkills --skill mat-solid-free-energy -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install learningmatter-mit/AtomisticSkills mat-solid-free-energy --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/learningmatter-mit/AtomisticSkills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/mat-solid-free-energy .claude/skills/mat-solid-free-energy && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
mat-solid-free-energy
GitHub stars
175
Token cost
~1.7k tokens
SKILL.md length
644 words
Files
4 (incl. scripts)
Skills in repo
129
Repo updated
First seen
Licence
MIT

At a glance

Calculate absolute solid Helmholtz free energy, and optional Gibbs free energy, with Frenkel-Ladd switching using portable MLIP wrappers on a pre-equilibrated periodic structure.

  • SKILL.md covers Goal, Prerequisites, Choosing a Foundation Potential and Preparing Inputs, plus 4 more sections
  • Runs Python scripts from its folder

What it does

Mat Solid Free Energy is an agent skill from learningmatter-mit/AtomisticSkills. Calculate absolute solid Helmholtz free energy, and optional Gibbs free energy, with Frenkel-Ladd switching using portable MLIP wrappers on a pre-equilibrated periodic structure.

Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including scripts (for example `examples/Si_MACE/README.md` and `scripts/run_frenkel_ladd.py`).

The repository describes itself as: Integrating AtomisticSkills into Agentic IDEs (Cursor, Claude Code, Codex, Google Antigravity, Hermes Agent, etc). The licence is MIT.

Example prompts

  • “/mat-solid-free-energy”

Requirements

  • Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit 7f2d86d. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Mat Solid Free Energy loads about 1.7k tokens when it runs. Until then it costs about 50 tokens; SKILL.md has 644 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~50
When it runs · the whole SKILL.md, loaded when a task matches
~1.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from learningmatter-mit/AtomisticSkills at commit 7f2d86d, republished under its MIT licence (© learningmatter-mit). 644 words, ~1,712 tokens.

Download SKILL.mdSave it as .claude/skills/mat-solid-free-energy/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
mat-solid-free-energy
description
Calculate absolute solid Helmholtz free energy, and optional Gibbs free energy, with Frenkel-Ladd switching using portable MLIP wrappers on a pre-equilibrated periodic structure.
metadata.category
materials
metadata.venv
mlip

Solid Free Energy

This skill calculates the absolute free energy of a crystalline solid using Frenkel-Ladd switching, which is a specific form of Thermodynamic Integration (TI).

Thermodynamic integration computes the free energy difference between two states by integrating the derivative of the Hamiltonian along a continuous coupling path. In this skill, the path interpolates between a physical MLIP Hamiltonian (the target state) and a harmonic Einstein-crystal reference (where the exact absolute free energy is analytically known).

Goal

Compute the Helmholtz free energy $F$ of a pre-equilibrated periodic solid at a target temperature, and optionally the Gibbs free energy $G = F + PV$ if pressure is supplied.

Prerequisites

  • A pre-equilibrated periodic solid structure in an ASE-readable format such as CIF or POSCAR.
  • The transferable MLIP wrapper stack must be available in the target repo via src.utils.mlips.loader.load_wrapper(...).
  • ASE and pymatgen are included in the mlip and fairchem environments.

[!IMPORTANT] This skill only performs the Frenkel-Ladd free-energy workflow. It does not relax the structure, build a supercell, equilibrate the volume, perform alchemical switching, or apply center-of-mass corrections.

Choosing a Foundation Potential

Frenkel-Ladd switching is an MD-based free-energy method, so both energy and force stability matter.

[!IMPORTANT]

  • Prefer materials models intended for PES or MD use, such as MACE-OMAT-0-small, MACE-MH-1, CHGNet-MatPES-*, or TensorNet-MatPES-*.
  • Use smaller or faster models for long switching trajectories when practical.
  • Avoid changing model family between preparation and Frenkel-Ladd unless you intentionally want a different free-energy reference.

Refer to the foundation-potentials skill for model selection guidance.

Preparing Inputs

This skill assumes the input structure is already appropriate for the target thermodynamic state point. For production workflows, the most useful upstream skills are:

  • mat-db-mp: Retrieve a starting bulk crystal structure from Materials Project.
  • mat-equation-of-state: Estimate an equilibrium cell volume and generate a better-relaxed starting point before finite-temperature sampling.
  • mat-lammps-md: Equilibrate a larger periodic cell at the target temperature or pressure using the same MLIP family.
  • mat-md-monitors: Check MD stability, thermostat behavior, volume drift, and equilibration while preparing the input trajectory.
  • mat-phonon: Screen for imaginary modes or other vibrational-instability warnings before running an expensive free-energy workflow.

Calculation Workflow

Run the standalone Frenkel-Ladd script:

bash
${CLAUDE_SKILL_DIR}/../../venv/run mlip python ${CLAUDE_SKILL_DIR}/scripts/run_frenkel_ladd.py \
    --structure path/to/pre_equilibrated_structure.cif \
    --name my_solid \
    --calculator mace \
    --model-name MACE-OMAT-0-small \
    --temperature 300 \
    --pressure-gpa 0.0 \
    --output-dir research/my_folder/frenkel_ladd
Show full SKILL.md (295 more words)Show less
Key Parameters
  • --structure: Pre-equilibrated periodic solid at the target state point.
  • --calculator: MLIP backend: mace, fairchem, or matgl.
  • --model-name: Model name or checkpoint path.
  • --task-name: Optional task head for multitask models.
  • --temperature: Temperature in K.
  • --pressure-gpa: Optional pressure in GPa. If provided, the script also reports Gibbs free energy.
  • --msd-equilibration-steps: NVT equilibration before MSD collection.
  • --msd-production-steps: NVT production used to estimate per-atom spring constants.
  • --equilibration-steps: Harmonic-reference equilibration between forward and backward switching.
  • --switching-steps: Number of MD steps in each switching direction.
  • --switching-type: linear or polynomial. Default is the smoother polynomial schedule.
  • --record-interval: Record every N MD steps.
Default Production Settings

The script defaults are:

  • timestep_fs = 1.0
  • thermostat_damping_fs = 100.0
  • msd_equilibration_steps = 1000
  • msd_production_steps = 10000
  • equilibration_steps = 5000
  • switching_steps = 25000
  • switching_type = polynomial
  • record_interval = 1
  • symmetrize_spring_constants = True

Output Files

  • frenkel_ladd_results.json: Summary including Helmholtz free energy, optional Gibbs free energy, dissipated energy, calculator metadata, and settings.
  • frenkel_ladd_traces.npz: Raw recorded arrays:
    • lambda_steps
    • forward_energy_contributions
    • backward_energy_contributions
    • spring_constants
    • mean_squared_displacement
  • input_structure.cif: Copy of the starting structure.
  • final_structure.cif: Final structure after backward switching.

Example

See examples/Si_MACE/ for a minimal silicon example using MACE with reduced step counts for demonstration.

bash
${CLAUDE_SKILL_DIR}/../../venv/run mlip python ${CLAUDE_SKILL_DIR}/scripts/run_frenkel_ladd.py \
    --structure ${CLAUDE_SKILL_DIR}/examples/Si_MACE/Si.cif \
    --name Si_demo \
    --calculator mace \
    --model-name MACE-OMAT-0-small \
    --temperature 300 \
    --msd-equilibration-steps 50 \
    --msd-production-steps 200 \
    --equilibration-steps 100 \
    --switching-steps 500 \
    --record-interval 5 \
    --output-dir research/frenkel_ladd/Si_demo

[!NOTE] The example is a smoke-test style demonstration. For production free-energy work, start from a genuinely pre-equilibrated structure and use the heavier default settings or stricter settings appropriate for your system.

Constraints

  • Environment:
    • mlip for MACE and MatGL/CHGNet models
    • fairchem for FairChem/UMA models
  • Periodic solids only: This method is intended for bulk crystalline solids, not molecules or non-periodic clusters.
  • Pre-equilibrated input required: The script assumes the supplied structure already represents the desired thermodynamic state point.
  • Quality control: Inspect abs(dissipated_energy) / num_atoms. Values much larger than about 0.05 eV/atom suggest poor switching reversibility and should be treated with caution.
  • Cost: Frenkel-Ladd calculations are expensive because they require long MD trajectories in both switching directions.

Author: Juno Nam Contact: GitHub @recisic

© learningmatter-mit, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (scripts) in skills/mat-solid-free-energy of learningmatter-mit/AtomisticSkills.

  • SKILL.md
  • examples/Si_MACE/README.md
  • examples/Si_MACE/Si.cif
  • scripts/run_frenkel_ladd.py

Open the folder on GitHubat commit 7f2d86d

Compare with similar skills

Mat Solid Free Energy next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Mat Solid Free Energy compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Mat Solid Free Energy this skilllearningmatter-mit/AtomisticSkills175—~1.7kAutomated safety check: PassMIT
Energy Calculatorbenchflow-ai/skillsbench1.8k—~437Automated safety check: PassApache-2.0
Optionsasgeirtj/system_prompts_leaks69k—~918Automated safety check: PassCC0-1.0
Bio Free Energy CalculationsGPTomics/bioSkills1.2k1 repos~4.5kAutomated safety check: PassMIT
Options PayoffHKUDS/Vibe-Trading35k—~6.8kAutomated safety check: PassMIT
Energy Procurementaffaan-m/ECC274k4 repos~7.4kAutomated safety check: PassApache-2.0

Similar skills

  • Energy Calculator

    benchflow-ai/skillsbench

    Calculate per-second RMS energy from audio files. An agent skill from benchflow-ai/skillsbench.

    1.8k GitHub stars~437 tokensUpdated 2 mo ago
    Auto-check passed
  • Options

    asgeirtj/system_prompts_leaks

    Present multiple design options as a vertical stack of anchored turns

    69k GitHub stars~918 tokensUpdated yesterday
    Auto-check passed
  • Performs alchemical free-energy calculations including relative binding free energy (RBFE / FEP+) and absolute binding free energy (ABFE) via OpenFE, FEP+, GROMACS, AMBER pmemd, and OpenMM with…

    1.2k GitHub starsUsed in 1 repo~4.5k tokens
    Research & ScienceAuto-check passed
  • Options Payoff

    HKUDS/Vibe-Trading

    Option P&L analysis methodology: payoff diagrams, breakeven calculation, multi-leg strategy visualization, and Greeks-based scenario analysis.

    35k GitHub stars~6.8k tokensUpdated yesterday
    Business, Finance & HRAuto-check passed
  • Energy Procurement

    affaan-m/ECC

    Procure electricity and natural gas for commercial and industrial facilities: tariff and rate-schedule optimization, demand-charge mitigation, supplier RFPs, fixed/index/block-and-index hedging…

    274k GitHub starsUsed in 4 repos~7.4k tokens
    Business, Finance & HRAuto-check passed
  • Energy Procurement

    affaan-m/ECC

    电力与燃气采购、电价优化、需量电费管理、可再生能源购电协议评估及多设施能源成本管理的编码化专业知识。基于能源采购经理在大型工商业用户中超过15年的经验。包括市场结构分析、对冲策略、负荷分析和可持续性报告框架。适用于采购能源、优化电价、管理需量电费、评估购电协议或制定能源策略时使用。

    274k GitHub starsUsed in 2 repos~2.5k tokens
    Business, Finance & HRAuto-check passed

More from learningmatter-mit/AtomisticSkills

All 129 skills in this repo
  • Drug Binding Site Definition

    learningmatter-mit/AtomisticSkills

    Define a docking search box (center coordinates + box dimensions in Angstroms) from a co-crystal ligand, binding-site residues, or a saved JSON specification.

    175 GitHub stars~2.9k tokensUpdated yesterday
    Auto-check passed
  • Drug Complex System Builder

    learningmatter-mit/AtomisticSkills

    Build a solvated, charge-neutralized protein-ligand complex for OpenMM molecular dynamics simulation.

    175 GitHub stars~2k tokensUpdated yesterday
    Auto-check passed
  • Drug Pocket Detection

    learningmatter-mit/AtomisticSkills

    Identify and rank ligandable pockets on a protein structure or model using geometry (fpocket) or an ML predictor (P2Rank).

    175 GitHub stars~4k tokensUpdated yesterday
    Auto-check passed
  • Chem Bond Dissociation

    learningmatter-mit/AtomisticSkills

    Calculate homolytic and heterolytic bond dissociation energies (BDEs) for all single bonds in a molecule using MLIPs with RDKit fragmentation.

    175 GitHub stars~2.5k tokensUpdated yesterday
    Auto-check passed
  • Chem Conformer Search

    learningmatter-mit/AtomisticSkills

    Generate molecular conformers with RDKit ETKDG, relax with MLIPs, and rank by energy with Boltzmann weighting.

    175 GitHub stars~1.3k tokensUpdated yesterday
    Auto-check passed
  • Chem DB Mof

    learningmatter-mit/AtomisticSkills

    Query multiple MOF databases (QMOF via MPContribs; ARC-MOF DB7/Majumdar et al.

    175 GitHub stars~1.9k tokensUpdated yesterday
    Auto-check passed

Questions about Mat Solid Free Energy

What does Mat Solid Free Energy do?

Calculate absolute solid Helmholtz free energy, and optional Gibbs free energy, with Frenkel-Ladd switching using portable MLIP wrappers on a pre-equilibrated periodic structure. Mat Solid Free Energy is an agent skill from learningmatter-mit/AtomisticSkills. Calculate absolute solid Helmholtz free energy, and optional Gibbs free energy, with Frenkel-Ladd switching using portable MLIP wrappers on a pre-equilibrated periodic structure.

How do I install Mat Solid Free Energy in Claude Code?

Run `npx skills add learningmatter-mit/AtomisticSkills --skill mat-solid-free-energy -a claude-code`. Or copy the skill folder (skills/mat-solid-free-energy in learningmatter-mit/AtomisticSkills) into .claude/skills/mat-solid-free-energy in your project. Claude Code loads it when a task matches its description.

How do I install Mat Solid Free Energy in Codex?

Run `npx skills add learningmatter-mit/AtomisticSkills --skill mat-solid-free-energy -a codex`. Or copy the skill folder (skills/mat-solid-free-energy in learningmatter-mit/AtomisticSkills) into .agents/skills/mat-solid-free-energy in your project. Codex loads it when a task matches its description.

Can I use Mat Solid Free Energy in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add learningmatter-mit/AtomisticSkills --skill mat-solid-free-energy -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/mat-solid-free-energy, .gemini/skills/mat-solid-free-energy, .github/skills/mat-solid-free-energy and .opencode/skills/mat-solid-free-energy in your project.

What does Mat Solid Free Energy need to run?

Going by SKILL.md and its folder, Mat Solid Free Energy needs Python for the scripts in its folder. Our summary lists: Python 3.

Does Mat Solid Free Energy access the network?

SKILL.md names 1 domain. As links in the text: github.com. This is read from the text; nothing was executed.

Is Mat Solid Free Energy safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Mat Solid Free Energy use?

Mat Solid Free Energy is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Mat Solid Free Energy use?

About 1.7k tokens (SKILL.md is roughly 6.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Mat Solid Free Energy?

Skills that share tags, products or a category with Mat Solid Free Energy: Energy Calculator (benchflow-ai/skillsbench, 1.8k stars), Options (asgeirtj/system_prompts_leaks, 69k stars), Bio Free Energy Calculations (GPTomics/bioSkills, 1.2k stars) and Options Payoff (HKUDS/Vibe-Trading, 35k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Mat Solid Free Energy?

learningmatter-mit (a GitHub organization) maintains it in learningmatter-mit/AtomisticSkills, which has 175 GitHub stars. The repository holds 129 skills in this directory. The repository was last updated on October 6, 2026.

Source: learningmatter-mit/AtomisticSkills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.