ml-mace-finetune

ml-mace-finetune is a skill for Claude Code, Codex from learningmatter-mit/AtomisticSkills. It costs 21 tokens per session (2,695 once invoked), scanned A, original, MIT.

A training workflow for adapting the MACE machine-learning interatomic potential to a custom dataset. The dataset contains reference energies, atomic forces, and optionally stresses for structures.

In plain words
What is it for?
Use it to prepare data, train a customized MACE model on a GPU, check convergence, and register the resulting model for later use.
Why use it?
A general-purpose model may not be accurate enough for a particular chemical system or property. Fine-tuning adjusts it using higher-fidelity examples from that domain.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/learningmatter-mit/atomisticskills/ml-mace-finetune
Any agent
npx skills add learningmatter-mit/AtomisticSkills --skill ml-mace-finetune
Clone the repo
git clone --depth 1 https://github.com/learningmatter-mit/AtomisticSkills

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for ml-mace-finetune

README.md
[![agentmods](https://agentmods.dev/badge/skills/learningmatter-mit/atomisticskills/ml-mace-finetune.svg)](https://agentmods.dev/skills/learningmatter-mit/atomisticskills/ml-mace-finetune)
Your own site
<a href="https://agentmods.dev/skills/learningmatter-mit/atomisticskills/ml-mace-finetune"><img src="https://agentmods.dev/badge/skills/learningmatter-mit/atomisticskills/ml-mace-finetune.svg" alt="Measured on agentmods" height="20"></a>
Per session 21 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,695 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00021 $0.02695
Opus 5 $0.00010 $0.01347
Sonnet 5 $0.00004 $0.00539
Haiku 4.5 $0.00002 $0.00269

Measured yesterday against content hash fbdfaa0e9acf, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

ml-mace-finetune scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

The scan reads SKILL.md. This mod also ships 3 executable files (scripts/extract_mace_logs.py, scripts/generate_mace_config.py, scripts/prepare_mace_data.py), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.agents/skills/ml-mace-finetune/SKILL.md · 160 lines

How it starts

The opening of the file, as written. The whole thing — 160 lines — stays where its author put it; the contents beside it link to each section on GitHub.

MACE Fine-tuning

Goal

To evaluate and improve the accuracy of a foundation MACE potential for a specific chemical system or physical property using the provided Python fine-tuning script and data-augmentation.

Instructions

  1. Prepare Labeled Dataset: Obtain diverse structures with high-fidelity labels (energy, forces, stress). See the /benchmark-finetuning workflow for details.
  2. Custom Data Conversion: Read the source data format and write a customized conversion script if needed, formatting it for the subsequent preparation step.
  3. Benchmarking: Predict results on the new labels and benchmark the foundation model using ml-mlip-benchmark.
  4. Data Preparation: Execute scripts/prepare_mace_data.py to convert JSON structures to .xyz data files.
  5. Config Generation: Execute scripts/generate_mace_config.py using the .xyz data to produce finetune_config.yaml.
  6. Fine-Tuning: Execute mace_run_train --config /path/to/finetune_config.yaml to begin fine-tuning natively on the GPU.
  7. Validation: Verify convergence and compare against the benchmarked foundation metrics.
  8. Registration: Use the register_model tool to register the newly fine-tuned model checkpoint into the local registry so future research tasks can discover and reuse it.

Training Configuration

MACE fine-tuning is divided into a data preparation step, a configuration generation step, and a standard native training run. The script scripts/prepare_mace_data.py generates .xyz files, and scripts/generate_mace_config.py converts arguments into a fully-formed finetune_config.yaml configuration compatible with the MACE default parser.

Basic Arguments (Data Prep Script)

Key Type Default Description
--data str (Required) Path to JSON file containing ASE/pymatgen structure dictionaries
--output-dir str ./fine_tuning_data Directory to save the converted .xyz data
--val-split float 0.1 Fraction of data to set aside for validation
--seed int 42 Random seed for validation splitting
--vasp-stress-conversion flag - If set, multiplies stress values by -1/160.2x to convert VASP raw kB to eV/ų

Read the full file on GitHub · 160 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 160 lines · 21 tokens per session scan A fbdfaa0e9acf

Subscribe to this mod's changes

ml-mace-finetune is a skill published in the GitHub repository learningmatter-mit/AtomisticSkills (158 stars, last pushed yesterday), licensed MIT. It adds 21 tokens to every session and 2,695 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.

Related

Other skills, from other repositories

hugging-face-trackio

Track and visualize ML training experiments with Trackio. Use when logging metrics during training (Python API) or retrieving/analyzing logged metrics (CLI). Supports real-time dashboard visualization, HF Space syncing, and JSON output for automation.

patchy631/ai-engineering-hub · 52 tokens

physicsnemo-discover

Official NVIDIA-authored guidance for navigating PhysicsNeMo — pick the model, datapipe, or example for a SciML/AI4Science task (surrogates, forecasting, downscaling, physics-informed, inverse, generative). Points at existing files via live repo search; never writes code. Do NOT use for installation or environment…

NVIDIA/physicsnemo · 124 tokens

pysr

Use when fitting equations to data with PySR or SymbolicRegression.jl, when a user wants an interpretable formula, symbolic model, scaling law, or empirical relation discovered from numeric data, or when debugging a PySR search that is slow, stuck, or giving poor equations.

astroautomata/PySR · 61 tokens

cellxgene-census-query

Query CZ CELLxGENE Census (61M+ cells). Filter by cell type/tissue/disease, retrieve expression data, and integrate with scanpy/PyTorch for population-scale single-cell analysis. Use this skill when: (1) Querying single-cell expression data by cell type, tissue, or disease, (2) Exploring available single-cell datasets…

PharMolix/OpenBioMed · 105 tokens

HomeSafe-Bench

VLM indoor safety hazard detection benchmark inspired by HomeSafeBench (arXiv 2509.23690).

SharpAI/DeepCamera · 28 tokens

depth-estimation

Real-time depth map privacy transforms using Depth Anything v2 (CoreML + PyTorch).

SharpAI/DeepCamera · 22 tokens