Hello-QM/catgo-LRG / server/catgo/workflow/skills/catgo-gibbs-pipeline
catgo-gibbs-pipeline
VerifiedCompute adsorption/reaction Gibbs free energies, free-energy diagrams, and electrochemical overpotentials (HER/ORR/OER/CO2RR/NRR) with VASP. The per-species pipeline is geo_opt → freq → Gibbs; CHE references; ΔG → η. Use whenever a study's target is a FREE energy (not raw DFT energy) — overpotential, free-energy diagram, ΔG of adsorption/reaction, limiting potential. Pairs with the catgo-campaign skill for orchestration.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 2.7 KB |
| examples/orr-pt111.md | markdown | 1.8 KB |
| references/method.md | markdown | 5.4 KB |
| scripts/build_freq_inputs.py | script | 4.7 KB |
examples/orr-pt111.md
View on GitHub# Example — ORR overpotential on Pt(111) (CHE)
A worked instance of the per-species `geo_opt → freq → Gibbs → η` pipeline, as run as a
CatGo md-orchestration campaign (`~/catgo-campaigns/Pt111-ORR`).
## Species (each: geo_opt → freq → G)
- clean Pt(111) 3×3×4 slab (bottom 2 layers fixed) — `compute`/128/`vasp_std`, k 4×4×1
- adsorbates: `*O` (fcc), `*OH` (top), `*OOH` (top), 1/9 ML — same slab settings
- gas references: `H2O`, `H2` — `shared`/32/`vasp_gam`, Γ-only
## Build a freq input (after a geo_opt converges)
All freq are **Γ-only, no NCORE, shared/32, vasp_gam** (cheap + robust; surface frozen):
```
# *OH adsorbate: free the O,H, fix the metal (Γ is the default)
catgo freq-inputs --structure <OH>/CONTCAR --out 04-freq/Pt111_OH_freq \
--free-elements O,H --ismear 1 --sigma 0.2
# H2O gas reference: all atoms free
catgo freq-inputs --structure <H2O>/CONTCAR --out 04-freq/H2O_freq \
--gas --ismear 0 --sigma 0.05
```
Submit all freq via the gas job template (`scripts/reference_gas.sb`: shared/32/vasp_gam).
## Assemble η
1. `catgo freq --mode adsorbed` (adsorbates) / `--mode gas` (H2O, H2) → ZPE + TΔS per species.
2. G = E + ZPE − TΔS. CHE: μ_O = G_H2O − G_H2; μ_OH = G_H2O − ½ G_H2; G(H⁺+e⁻) = ½ G_H2.
3. ΔG1..ΔG4 along *OOH→*O→*OH→* ; U_L = max ΔG_i/e ; **η = 1.23 − U_L**.
4. Free-energy diagram + ΔG table → `analysis/`.
## Lessons from the live run
- Judge geo_opt convergence by **`FORCES: max atom` < 0.03**, not by dE (a small dE hid a
0.2 eV/Å residual force on *OH).
- A crude hand-built `*OOH` gave 3 eV/Å forces that wouldn't relax — rebuild adsorbates with
physical bond lengths/angles (O–O 1.44, O–H 0.98, ∠OOH ~107°).
- The "kinetic energy error for atom (will be added to EATOM)" OUTCAR line is benign.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deployment | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |