Agent skill

Gibbs Free Energy

by Hello-QM in Hello-QM/catgo-LRG

A skill your agent uses when the user asks for Gibbs free energy, zero-point energy (ZPE), thermal corrections, or thermodynamic properties from DFT + frequency data.

AGPL-3.0Auto-check passed

Install Gibbs Free Energy

skills CLI
$ npx skills add Hello-QM/catgo-LRG --skill gibbs-free-energy -a claude-code

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

GitHub CLI
$ gh skill install Hello-QM/catgo-LRG gibbs-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/Hello-QM/catgo-LRG.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/gibbs .claude/skills/gibbs-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
gibbs-free-energy
GitHub stars
205
Token cost
~1.5k tokens
SKILL.md length
481 words
Files
1
Skills in repo
75
Repo updated
First seen
Licence
AGPL-3.0

At a glance

A skill your agent uses when the user asks for Gibbs free energy, zero-point energy (ZPE), thermal corrections, or thermodynamic properties from DFT + frequency data.

  • Works in 5 steps: Create workflow and add structure → Add geo_opt task → Add frequency task → …
  • The user asks for Gibbs free energy
  • SKILL.md covers Theory, Discussion Checkpoints, MCP Workflow and Python API, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Gibbs Free Energy is an agent skill from Hello-QM/catgo-LRG. Use when the user asks for Gibbs free energy, zero-point energy (ZPE), thermal corrections, or thermodynamic properties from DFT + frequency data.

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: AI-driven workbench for computational materials science — interactive 3D structure viewer, natural-language CatBot assistant, visual DAG workflow engine, HPC job submission… The licence is AGPL-3.0.

When your agent uses it

  • The user asks for Gibbs free energy
  • Zero-point energy (ZPE)
  • Thermal corrections
  • Thermodynamic properties from DFT + frequency data

Example prompts

  • “/gibbs-free-energy”

Requirements

  • Python 3

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Create workflow and add structure
  2. Add geo_opt task
  3. Add frequency task
  4. Add gibbs_energy task
  5. Submit

What it can do on your machine

Read from SKILL.md and the folder at commit fd6291b. 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

    No scripts in the folder and no shell commands in SKILL.md (its code samples are json and python).

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

  • Network

    No URLs in SKILL.md.

    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

Gibbs Free Energy loads about 1.5k tokens when it runs. Until then it costs about 41 tokens; SKILL.md has 481 words of instructions outside code blocks.

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

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from Hello-QM/catgo-LRG at commit fd6291b, republished under its AGPL-3.0 licence (© Hello-QM). 481 words, ~1,489 tokens.

Download SKILL.mdSave it as .claude/skills/gibbs-free-energy/SKILL.md (or your agent's skills folder).
name
gibbs-free-energy
description
Use when the user asks for Gibbs free energy, zero-point energy (ZPE), thermal corrections, or thermodynamic properties from DFT + frequency data.

Gibbs Free Energy Calculation

Theory

G = E_DFT + ZPE - TS

Where:

  • E_DFT = electronic energy from geometry optimization (eV)
  • ZPE = zero-point energy = (1/2) * sum(h * nu_i) for all real frequencies
  • TS = entropic contribution at temperature T
Phase Modes
PhaseTreatmentWhen to Use
adsorbedHarmonic approximation: all 3N modes treated as vibrations. No translational/rotational entropy.Adsorbate on surface slab
gasIdeal gas: translational + rotational + vibrational partition functions (Shomate/statistical mechanics).Free molecule in gas phase (H2, H2O, O2, etc.)
Frequency Cutoff

Low-frequency modes (< 50 cm-1) in adsorbed species are often numerical noise from frustrated translations/rotations. These are replaced with freq_cutoff (default 50 cm-1) to avoid divergent entropy contributions.

Discussion Checkpoints

🔴 Must discuss with user:

  • Phase (adsorbed vs gas) — wrong phase gives wrong entropy; adsorbed species use harmonic approximation (no translational/rotational entropy), gas-phase species use ideal gas partition function; the difference is 0.3-0.6 eV for molecules like H2O

🟡 Recommend confirming:

  • Temperature (default: 298.15 K) — change for high-temperature catalysis (e.g., 600 K for thermal CO2 reduction, 373 K for steam reforming)
  • Frequency cutoff (default: 50 cm-1) — replaces frustrated translations/rotations below this threshold for adsorbed species; increase to 100 cm-1 if anomalous entropy values appear

🟢 Safe defaults:

  • Harmonic approximation for adsorbed species
  • Ideal gas partition function for gas-phase molecules
  • Pressure = 101325 Pa (1 atm)
  • freq_cutoff = 50 cm-1

MCP Workflow

Step 1: Create workflow and add structure
json
{"tool": "catgo_workflow_engine", "arguments": {
  "action": "create", "name": "Gibbs energy - OH on Pt(111)"
}}
Step 2: Add geo_opt task
json
{"tool": "catgo_workflow_engine", "arguments": {
  "action": "add_task",
  "workflow_id": "wf_abc123",
  "task_type": "geo_opt",
  "params": {"software": "vasp", "ENCUT": 520, "EDIFFG": -0.02}
}}
Step 3: Add frequency task
json
{"tool": "catgo_workflow_engine", "arguments": {
  "action": "add_task",
  "workflow_id": "wf_abc123",
  "task_type": "freq",
  "depends_on": "task_opt",
  "params": {
    "software": "vasp",
    "freeze_mode": "layers",
    "freeze_layers": 4
  }
}}
Step 4: Add gibbs_energy task
json
{"tool": "catgo_workflow_engine", "arguments": {
  "action": "add_task",
  "workflow_id": "wf_abc123",
  "task_type": "gibbs_energy",
  "depends_on": ["task_opt", "task_freq"],
  "params": {
    "phase": "adsorbed",
    "temperature": 298.15,
    "freq_cutoff": 50
  }
}}
Step 5: Submit
json
{"tool": "catgo_workflow_engine", "arguments": {
  "action": "submit", "workflow_id": "wf_abc123"
}}

Python API

python
from catgo.workflow import Workflow

wf = Workflow("Gibbs energy - OH on Pt(111)")

inp = wf.add_task("structure_input", structure=slab_oh_json)

opt = wf.add_task("geo_opt",
    structure=inp.output.structure,
    software="vasp", ENCUT=520, EDIFFG=-0.02)

frq = wf.add_task("freq",
    structure=opt.output.structure,
    software="vasp",
    freeze_mode="layers", freeze_layers=4)

gib = wf.add_task("gibbs_energy",
    energy=opt.output.energy,
    frequencies=frq.output.frequencies,
    phase="adsorbed",
    temperature=298.15,
    freq_cutoff=50)

wf.submit()

Output References

python
gib.output.gibbs        # G in eV
gib.output.zpe          # ZPE in eV
gib.output.entropy      # TS in eV
gib.output.enthalpy     # H in eV

Checking Results

json
{"tool": "catgo_workflow_engine", "arguments": {
  "action": "get_result", "workflow_id": "wf_abc123", "task_id": "task_gibbs"
}}

Key Parameters

ParameterDefaultDescription
phase"adsorbed""adsorbed" (harmonic) or "gas" (ideal gas)
temperature298.15Temperature in Kelvin
freq_cutoff50Replace frequencies below this (cm-1) with this value. Adsorbed phase only.
pressure101325Pressure in Pa. Gas phase only.
Show full SKILL.md (203 more words)Show less

Why Gibbs Free Energy Matters

For reaction energy diagrams (OER, HER, CO2RR, NRR), you must use Gibbs free energies, not raw DFT electronic energies. The difference matters:

ContributionTypical magnitude
ZPE (zero-point energy)+0.05 to +0.5 eV
-TS (entropic correction)-0.1 to -0.6 eV
Total correction (G - E_DFT)-0.1 to +0.3 eV

Gas-phase molecules (H2, H2O, CO2, N2) have large translational and rotational entropy contributions. Adsorbed species lose these degrees of freedom, so the correction differs significantly between gas and adsorbed phases. Omitting the gibbs_energy step introduces systematic errors of 0.2-0.5 eV per reaction step.

Every species in a reaction (intermediates AND gas-phase references) must go through: geo_opt --> freq --> gibbs_energy.

Common Pitfalls

  1. Never skip the freq task -- ZPE and TS require vibrational frequencies.
  2. For adsorbed species, always freeze slab bottom layers in freq calculation.
  3. Gas-phase references (H2, H2O, CO2, N2, NH3) must use phase="gas" to include translational and rotational entropy.
  4. The energy input must come from geo_opt (relaxed), not single_point.
  5. If you get anomalously large entropy, check for near-zero frequencies -- increase freq_cutoff or verify the structure is properly relaxed.
  6. Never use raw DFT energies (E_DFT) in reaction energy diagrams. Always complete the full chain: geo_opt --> freq --> gibbs_energy.

© Hello-QM, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills/gibbs of Hello-QM/catgo-LRG.

Open the folder on GitHubat commit fd6291b

Compare with similar skills

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

Gibbs Free Energy compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Gibbs Free Energy this skillHello-QM/catgo-LRG205—~1.5kAutomated safety check: PassAGPL-3.0
Energy Procurementaffaan-m/ECC277k4 repos~7.4kAutomated safety check: PassApache-2.0
Energy Procurementaffaan-m/ECC277k2 repos~2.5kAutomated safety check: PassApache-2.0
Zero Trustsickn33/agentic-awesome-skills47k2 repos~3.2kAutomated safety check: PassMIT
Energy Procurementsickn33/agentic-awesome-skills47k2 repos~7.4kAutomated safety check: PassMIT
Cloudflare Zero Trustsickn33/agentic-awesome-skills47k2 repos~2.8kAutomated safety check: WarnMIT

Similar skills

  • 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…

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

    affaan-m/ECC

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

    277k GitHub starsUsed in 2 repos~2.5k tokens
    Business, Finance & HRAuto-check passed
  • Zero Trust

    sickn33/agentic-awesome-skills

    Implement zero-trust network architecture. An agent skill from sickn33/agentic-awesome-skills.

    47k GitHub starsUsed in 2 repos~3.2k tokens
    Backend & APIsAuto-check passed
  • Energy Procurement

    sickn33/agentic-awesome-skills

    Codified expertise for electricity and gas procurement, tariff optimisation, demand charge management, renewable PPA evaluation, and multi-facility energy cost management.

    47k GitHub starsUsed in 2 repos~7.4k tokens
    Business, Finance & HRAuto-check passed
  • Cloudflare Zero Trust

    sickn33/agentic-awesome-skills

    Protect internal apps with Cloudflare Access, device posture, and Zero Trust policies.

    47k GitHub starsUsed in 2 repos~2.8k tokens
    DevOps & CloudAuto-check: warnings
  • Implementing Zero Trust With Beyondcorp

    mukul975/Anthropic-Cybersecurity-Skills

    Configures Google BeyondCorp Enterprise Identity-Aware Proxy (IAP) as the access enforcement point for web applications, defining Access Context Manager access levels from device trust and network…

    34k GitHub stars~732 tokensUpdated 1 mo ago
    SecurityAuto-check passed

More from Hello-QM/catgo-LRG

All 75 skills in this repo
  • Campaign Md Orchestration

    Hello-QM/catgo-LRG

    Drive a file-first, agent-in-the-loop computational campaign via a folder + markdown tree (no DB).

    205 GitHub stars~1.6k tokensUpdated 18 days ago
    Auto-check passed
  • Catgo Gibbs Pipeline

    Hello-QM/catgo-LRG

    Compute adsorption/reaction Gibbs free energies, free-energy diagrams, and electrochemical overpotentials (HER/ORR/OER/CO2RR/NRR) with VASP.

    205 GitHub stars~669 tokensUpdated 18 days ago
    Auto-check passed
  • Abinit

    Hello-QM/catgo-LRG

    Generate and manage ABINIT DFT calculations. An agent skill from Hello-QM/catgo-LRG.

    205 GitHub stars~963 tokensUpdated 18 days ago
    Auto-check passed
  • Adsorbate Placement

    Hello-QM/catgo-LRG

    A skill your agent uses when the user asks to place an adsorbate molecule on a surface, find adsorption sites, or set up a surface+adsorbate model for DFT.

    205 GitHub stars~3k tokensUpdated 18 days ago
    Auto-check passed
  • Adsorption Energy

    Hello-QM/catgo-LRG

    A skill your agent uses when the user asks for adsorption energy, binding energy, or wants to compare how strongly a molecule binds to a surface.

    205 GitHub stars~1.4k tokensUpdated 18 days ago
    Auto-check passed
  • Analysis Router

    Hello-QM/catgo-LRG

    A skill your agent uses when the user asks to analyze computational results: Gibbs free energy, OER/HER/CO2RR overpotentials, adsorption energy, convergence tests, DOS/d-band analysis, or Bader…

    205 GitHub stars~869 tokensUpdated 18 days ago
    Auto-check passed

Questions about Gibbs Free Energy

What does Gibbs Free Energy do?

A skill your agent uses when the user asks for Gibbs free energy, zero-point energy (ZPE), thermal corrections, or thermodynamic properties from DFT + frequency data. Gibbs Free Energy is an agent skill from Hello-QM/catgo-LRG. Use when the user asks for Gibbs free energy, zero-point energy (ZPE), thermal corrections, or thermodynamic properties from DFT + frequency data.

When should I use Gibbs Free Energy?

Gibbs Free Energy fits situations like: the user asks for Gibbs free energy; zero-point energy (ZPE); thermal corrections; thermodynamic properties from DFT + frequency data.

How do I install Gibbs Free Energy in Claude Code?

Run `npx skills add Hello-QM/catgo-LRG --skill gibbs-free-energy -a claude-code`. Or copy the skill folder (.claude/skills/gibbs in Hello-QM/catgo-LRG) into .claude/skills/gibbs-free-energy in your project. Claude Code loads it when a task matches its description.

How do I install Gibbs Free Energy in Codex?

Run `npx skills add Hello-QM/catgo-LRG --skill gibbs-free-energy -a codex`. Or copy the skill folder (.claude/skills/gibbs in Hello-QM/catgo-LRG) into .agents/skills/gibbs-free-energy in your project. Codex loads it when a task matches its description.

Can I use Gibbs 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 Hello-QM/catgo-LRG --skill gibbs-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/gibbs-free-energy, .gemini/skills/gibbs-free-energy, .github/skills/gibbs-free-energy and .opencode/skills/gibbs-free-energy in your project.

What does Gibbs Free Energy need to run?

SKILL.md names no scripts, command-line tools or credentials: Gibbs Free Energy is instructions for the agent only. Our summary lists: Python 3.

Does Gibbs Free Energy access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Gibbs 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. Review the folder before installing.

What licence does Gibbs Free Energy use?

Gibbs Free Energy is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Gibbs Free Energy use?

About 1.5k tokens (SKILL.md is roughly 6k 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 Gibbs Free Energy?

Skills that share tags, products or a category with Gibbs Free Energy: Energy Procurement (affaan-m/ECC, 277k stars), Energy Procurement (affaan-m/ECC, 277k stars), Zero Trust (sickn33/agentic-awesome-skills, 47k stars) and Energy Procurement (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 Gibbs Free Energy?

Hello-QM (a GitHub user) maintains it in Hello-QM/catgo-LRG, which has 205 GitHub stars. The repository holds 75 skills in this directory. The repository was last updated on September 22, 2026.

Source: Hello-QM/catgo-LRG on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.