Agent skill

Chem Sorption Gcmc

by learningmatter-mit in learningmatter-mit/AtomisticSkills

Calculates gas adsorption isotherms via BVT/GCMC Monte Carlo simulations in a porous framework using MLIP.

MITAuto-check passed

Install Chem Sorption Gcmc

skills CLI
$ npx skills add learningmatter-mit/AtomisticSkills --skill chem-sorption-gcmc -a claude-code

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

GitHub CLI
$ gh skill install learningmatter-mit/AtomisticSkills chem-sorption-gcmc --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/chem-sorption-gcmc .claude/skills/chem-sorption-gcmc && 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
chem-sorption-gcmc
GitHub stars
176
Token cost
~926 tokens
SKILL.md length
299 words
Files
16 (incl. scripts)
Skills in repo
129
Repo updated
First seen
Licence
MIT

At a glance

Calculates gas adsorption isotherms via BVT/GCMC Monte Carlo simulations in a porous framework using MLIP.

  • Works in 2 steps: Perform Single-Component GCMC… → Perform Multi-Component GCMC (Optional):…
  • SKILL.md covers Goal, Prerequisites, Instructions and Examples, plus 1 more section
  • Runs Python and Shell scripts from its folder

What it does

Chem Sorption Gcmc is an agent skill from learningmatter-mit/AtomisticSkills. Calculates gas adsorption isotherms via BVT/GCMC Monte Carlo simulations in a porous framework using MLIP.

Its SKILL.md is about 930 tokens, which your agent loads only when the skill is triggered. The skill folder holds 20 other files, including scripts (for example `examples/README.md`, `examples/multi_gas/input_configs.yaml` and `examples/single_gas/input_configs.yaml`).

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

  • “Use the chem-sorption-gcmc skill to calculate gas adsorption isotherms via BVT/GCMC Monte Carlo simulations in a porous framework using MLIP”
  • “/chem-sorption-gcmc”

Requirements

  • Python 3
  • A Bash shell

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

  1. Perform Single-Component GCMC (Optional): If you are investigating a single gas species, use run_gcmc.py.
  2. Perform Multi-Component GCMC (Optional): If you are simulating a gas mixture (e.g. flue gas separation 15% CO2 / 85% N2), use…

What it can do on your machine

Read from SKILL.md and the folder at commit 6257444. 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 11 files in scripts/ (Python and Shell), 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

Chem Sorption Gcmc loads about 926 tokens when it runs. Until then it costs about 31 tokens; SKILL.md has 299 words of instructions outside code blocks.

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

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 6257444, republished under its MIT licence (© learningmatter-mit). 299 words, ~926 tokens.

Download SKILL.mdSave it as .claude/skills/chem-sorption-gcmc/SKILL.md (or your agent's skills folder). This skill also uses 15 other files; get the full folder from GitHub.
name
chem-sorption-gcmc
description
Calculates gas adsorption isotherms via BVT/GCMC Monte Carlo simulations in a porous framework using MLIP.
metadata.category
materials, chemistry
metadata.venv
fairchem

chem-sorption-gcmc

Goal

To predict the macroscopic adsorption uptake of a gas (or gas mixture) in a porous material at a specific temperature and pressure. The skill relies on Grand Canonical Monte Carlo (GCMC) simulations where the host-guest and guest-guest interactions are calculated using a Machine Learning Interatomic Potential (MLIP: MACE, FairChem, MatGL).

Prerequisites

  • Input: A relaxed framework structure in CIF (or XYZ) format. The structure should ideally be processed by chem-sorption-relax to ensure proper supercell dimensions.
  • Environment: Depends on the MLIP used (fairchem for FairChem; mlip for MACE and MatGL).

Instructions

  1. Perform Single-Component GCMC (Optional): If you are investigating a single gas species, use run_gcmc.py.
bash
# (or other MLIP-specific env)
${CLAUDE_SKILL_DIR}/../../venv/run fairchem python ${CLAUDE_SKILL_DIR}/scripts/run_gcmc.py \
    --cif path/to/relaxed_supercell.cif \
    --calculator fairchem \
    --model-name uma-s-1p1 \
    --task-name omol \
    --steps 50000 \
    --temperature-K 298 \
    --pressure-bar 1.0 \
    --adsorbate CO2 \
    --output-dir ./results/single_gcmc
  1. Perform Multi-Component GCMC (Optional): If you are simulating a gas mixture (e.g. flue gas separation 15% CO2 / 85% N2), use run_gcmc_multi.py.
bash
${CLAUDE_SKILL_DIR}/../../venv/run fairchem python ${CLAUDE_SKILL_DIR}/scripts/run_gcmc_multi.py \
    --cif path/to/relaxed_supercell.cif \
    --calculator fairchem \
    --model-name uma-s-1p1 \
    --task-name omol \
    --steps 50000 \
    --temperature-K 298 \
    --gases CO2 N2 \
    --y 0.15 0.85 \
    --p-total-bar 1.0 \
    --output-dir ./results/multi_gcmc
Key Parameters
  • --cif: Path to the relaxed host framework.
  • --calculator: The backend MLIP (fairchem, mace, matgl).
  • --model-name: Name or path to the MLIP weights (e.g., uma-s-1p1.pt, MACE-MH-1).
  • --task-name: Optional, required by some models (omol for UMA and MACE-MH).
  • --steps: Number of Monte Carlo steps (minimum 50,000 recommended for equilibration).
  • --temperature-K: Sim temperature.
  • --pressure-bar (Single): Gas pressure in bar.
  • --p-total-bar (Multi): Total mixture pressure in bar.
  • --gases / --y (Multi): Species list and corresponding mole fractions in the vapor phase.

Examples

Example 1: Generating an Isotherm Point (CO2, 0.1 bar, 298K) with UMA:

bash
${CLAUDE_SKILL_DIR}/../../venv/run fairchem python ${CLAUDE_SKILL_DIR}/scripts/run_gcmc.py \
    --cif ./data/MOF-5_supercell.cif \
    --calculator fairchem \
    --model-name uma-s-1p1 \
    --task-name omol \
    --steps 50000 \
    --temperature-K 298 \
    --pressure-bar 0.1 \
    --adsorbate CO2 \
    --output-dir ./out/0.1_bar

Constraints

  • Simulation Time: GCMC with MLIPs can be computationally intensive. Use GPUs when available (--device cuda).
  • Equilibration: You MUST check the generated nmols.png and energy.png inside the output-dir to visually confirm that the number of molecules and energy have plateaued (equilibrated). If the trend is still rising/falling at the end of the simulation, you must re-run with more --steps (or restart the trajectory).
  • Restarting: You can pass --restart-traj ./out/mc.traj to continue a previous run.

Author: Artur Lyssenko Contact: GitHub @arturlyssenko12

© 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 15 other files (scripts) in skills/chem-sorption-gcmc of learningmatter-mit/AtomisticSkills.

  • SKILL.md
  • examples/README.md
  • examples/multi_gas/input_configs.yaml
  • examples/single_gas/input_configs.yaml
  • examples/test_gcmc.sh
  • scripts/ase_mc/AtomisticSkills.code-workspace
  • scripts/ase_mc/__init__.py
  • scripts/ase_mc/ensembles.py
  • scripts/ase_mc/logger.py
  • scripts/ase_mc/mc.py
  • scripts/ase_mc/moves.py
  • scripts/ase_mc/moveset.py
  • scripts/ase_mc/utility.py
  • scripts/gcmc_common.py
  • scripts/run_gcmc.py
  • scripts/run_gcmc_multi.py

Open the folder on GitHubat commit 6257444

Compare with similar skills

Chem Sorption Gcmc 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.

Chem Sorption Gcmc compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Chem Sorption Gcmc this skilllearningmatter-mit/AtomisticSkills176—~926Automated safety check: PassMIT
Monte Carlo Remediationsickn33/agentic-awesome-skills47k1 repos~4kAutomated safety check: PassApache-2.0
Monte Carlo Preventsickn33/agentic-awesome-skills47k1 repos~3.3kAutomated safety check: PassMIT
Eol Resistor Calculatorsickn33/agentic-awesome-skills47k1 repos~3.5kAutomated safety check: PassMIT
Monte Carlo Context Detectionsickn33/agentic-awesome-skills47k1 repos~2.6kAutomated safety check: WarnMIT
Monte Carlo Push Ingestionsickn33/agentic-awesome-skills47k1 repos~4.6kAutomated safety check: PassMIT

Similar skills

  • Monte Carlo Remediation

    sickn33/agentic-awesome-skills

    Investigate and remediate data quality alerts using Monte Carlo MCP tools.

    47k GitHub starsUsed in 1 repo~4k tokens
    DevelopmentAuto-check passed
  • Monte Carlo Prevent

    sickn33/agentic-awesome-skills

    Surfaces Monte Carlo data observability context (table health, alerts, lineage, blast radius) before SQL/dbt edits.

    47k GitHub starsUsed in 1 repo~3.3k tokens
    Data & AnalyticsAuto-check passed
  • Eol Resistor Calculator

    sickn33/agentic-awesome-skills

    Calculates and validates end-of-line (EOL, SEOL, DEOL, TEOL) resistor loops for intrusion alarm panels (Honeywell, DSC, Paradox, Bosch) with wire gauge drop and state tables.

    47k GitHub starsUsed in 1 repo~3.5k tokens
    Auto-check passed
  • Monte Carlo Context Detection

    sickn33/agentic-awesome-skills

    Route data-related requests to the right Monte Carlo skill or workflow.

    47k GitHub starsUsed in 1 repo~2.6k tokens
    Data & AnalyticsAuto-check: warnings
  • Monte Carlo Push Ingestion

    sickn33/agentic-awesome-skills

    Expert guide for pushing metadata, lineage, and query logs to Monte Carlo from any data warehouse.

    47k GitHub starsUsed in 1 repo~4.6k tokens
    DatabasesAuto-check passed
  • Monte Carlo Asset Health

    sickn33/agentic-awesome-skills

    Curated upstream guidance for Monte Carlo Asset Health; use when the workflow matches the user goal.

    47k GitHub starsUsed in 1 repo~2.4k tokens
    Auto-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.

    176 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.

    176 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).

    176 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.

    176 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.

    176 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.

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

Questions about Chem Sorption Gcmc

What does Chem Sorption Gcmc do?

Calculates gas adsorption isotherms via BVT/GCMC Monte Carlo simulations in a porous framework using MLIP. Chem Sorption Gcmc is an agent skill from learningmatter-mit/AtomisticSkills. Calculates gas adsorption isotherms via BVT/GCMC Monte Carlo simulations in a porous framework using MLIP.

How do I install Chem Sorption Gcmc in Claude Code?

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

How do I install Chem Sorption Gcmc in Codex?

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

Can I use Chem Sorption Gcmc 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 chem-sorption-gcmc -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/chem-sorption-gcmc, .gemini/skills/chem-sorption-gcmc, .github/skills/chem-sorption-gcmc and .opencode/skills/chem-sorption-gcmc in your project.

What does Chem Sorption Gcmc need to run?

Going by SKILL.md and its folder, Chem Sorption Gcmc needs Python and a shell for the scripts in its folder. Our summary lists: Python 3; A Bash shell.

Does Chem Sorption Gcmc 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 Chem Sorption Gcmc 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 Chem Sorption Gcmc use?

Chem Sorption Gcmc 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 Chem Sorption Gcmc use?

About 926 tokens (SKILL.md is roughly 3.7k 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 Chem Sorption Gcmc?

Skills that share tags, products or a category with Chem Sorption Gcmc: Monte Carlo Remediation (sickn33/agentic-awesome-skills, 47k stars), Monte Carlo Prevent (sickn33/agentic-awesome-skills, 47k stars), Eol Resistor Calculator (sickn33/agentic-awesome-skills, 47k stars) and Monte Carlo Context Detection (sickn33/agentic-awesome-skills, 47k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Chem Sorption Gcmc?

learningmatter-mit (a GitHub organization) maintains it in learningmatter-mit/AtomisticSkills, which has 176 GitHub stars. The repository holds 129 skills in this directory. The repository was last updated on October 7, 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.