Agent skill

Catgo Gibbs Pipeline

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

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

AGPL-3.0Auto-check passedDevelopment

Install Catgo Gibbs Pipeline

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

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

GitHub CLI
$ gh skill install Hello-QM/catgo-LRG catgo-gibbs-pipeline --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/server/catgo/workflow/skills/catgo-gibbs-pipeline .claude/skills/catgo-gibbs-pipeline && 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
catgo-gibbs-pipeline
GitHub stars
205
Token cost
~669 tokens
SKILL.md length
282 words
Files
4 (incl. scripts, references)
Skills in repo
75
Repo updated
First seen
Licence
AGPL-3.0

At a glance

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

  • Works in 3 steps: geo_opt each species (force-converged) →… → catgo freq-inputs from each CONTCAR →… → Assemble ΔG_i along the pathway → U_L =…
  • A studys target is a FREE energy (not raw DFT energy) — overpotential
  • SKILL.md covers When to use, Core rules (the why), Bundled resources and Flow
  • Runs Python scripts from its folder

What it does

Catgo Gibbs Pipeline is an agent skill from Hello-QM/catgo-LRG. Compute adsorption/reaction Gibbs free energies, free-energy diagrams, and electrochemical overpotentials (HER/ORR/OER/CO2RR/NRR) with VASP. The per-species pipeline is geoopt → 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.

Its SKILL.md is about 670 tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including scripts and reference files (for example `examples/orr-pt111.md`, `references/method.md` and `scripts/build_freq_inputs.py`).

It sits in Development, covering Diagrams. 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

  • A studys target is a FREE energy (not raw DFT energy) — overpotential
  • Free-energy diagram
  • ΔG of adsorption/reaction
  • Limiting potential

Example prompts

  • “/catgo-gibbs-pipeline”

Requirements

  • Python 3

Workflow steps

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

  1. geo_opt each species (force-converged) → E.
  2. catgo freq-inputs from each CONTCAR → submit freq → catgo freq --mode adsorbed|gas
  3. Assemble ΔG_i along the pathway → U_L = max ΔG_i/e → η = |1.23 − U_L|; free-energy

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

    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

    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

Catgo Gibbs Pipeline loads about 669 tokens when it runs, and up to ~2.1k if it reads all its reference files. Until then it costs about 111 tokens; SKILL.md has 282 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~111
When it runs · the whole SKILL.md, loaded when a task matches
~669
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.1k

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 Hello-QM/catgo-LRG at commit fd6291b, republished under its AGPL-3.0 licence (© Hello-QM). 282 words, ~669 tokens.

Download SKILL.mdSave it as .claude/skills/catgo-gibbs-pipeline/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
catgo-gibbs-pipeline
description
Compute 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.

catgo-gibbs-pipeline — adsorption/reaction free energies & overpotential

TL;DR: G = E_DFT + ZPE − TΔS. Every species in a ΔG needs geo_opt and freq. Per-species pipeline: geo_opt → freq → Gibbs; assemble ΔG → η.

When to use

Any study whose target is a free energy — overpotential η, free-energy diagram, ΔG of adsorption/reaction, limiting potential (HER/ORR/OER/CO2RR/NRR, adsorption thermo). Raw geo_opt energies are NOT enough: add ZPE + TΔS from frequencies.

Core rules (the why)

  • Free energy needs freq. Skipping freq gives wrong ΔG and wrong η.
  • Per species, pipeline not barrier. Each species' freq fires as ITS geo_opt converges — don't wait for siblings, don't wait for a reminder.
  • Convergence by force, not dE: FORCES: max atom < |EDIFFG|.
  • CHE, not O2: G(H⁺+e⁻)=½G_H2; derive O/OH from H2O+H2; never compute O2.
  • Gas refs cheap: Γ-only + vasp_gam on shared; slabs vasp_std + k-mesh on compute.

Bundled resources

  • catgo freq-inputs — build a VASP freq input from a relaxed CONTCAR/POSCAR (adsorbate: fix surface, free adsorbate atoms; gas: all free). Runs from ANY directory: catgo freq-inputs --structure <CONTCAR> --out <dir> [--gas | --free-elements O,H]. Wraps scripts/build_freq_inputs.py (call the script directly only if catgo isn't on PATH; resolve it as <this skill base>/scripts/build_freq_inputs.py, never a hardcoded ~/.claude/... path).
  • references/method.md — full thermo + freq setup + CHE/ORR/OER/HER pathway formulas + the η definition. Read for the exact equations.
  • examples/orr-pt111.md — a worked ORR-on-Pt(111) instance (build freq, assemble η).

Flow

  1. geo_opt each species (force-converged) → E.
  2. catgo freq-inputs from each CONTCAR → submit freq → catgo freq --mode adsorbed|gas → ZPE + TΔS → G.
  3. Assemble ΔG_i along the pathway → U_L = max ΔG_i/e → η = |1.23 − U_L|; free-energy diagram + ΔG table. (Building blocks: the vasp-freq, gibbs, her, oer, energy-diagram skills.)

In a CatGo campaign, wire this into plan.md and let the loop fire freq per species — see the catgo-campaign + catgo-campaign-loop skills.

© 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

SKILL.md and 3 other files (scripts, references) in server/catgo/workflow/skills/catgo-gibbs-pipeline of Hello-QM/catgo-LRG.

  • SKILL.md
  • examples/orr-pt111.md
  • references/method.md
  • scripts/build_freq_inputs.py

Open the folder on GitHubat commit fd6291b

Compare with similar skills

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

Catgo Gibbs Pipeline compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Catgo Gibbs Pipeline this skillHello-QM/catgo-LRG205—~669Automated safety check: PassAGPL-3.0
Archify Diagramstt-a1i/archify82k—~2.9kAutomated safety check: PassMIT
JSON Canvasheyitsnoah/claudesidian2.6k18 repos~3.5kAutomated safety check: PassMIT
Diagram Designcathrynlavery/diagram-design49k1 repos~7.6kAutomated safety check: PassMIT
Fireworks Tech Graphtisfeng/Easydict15k1 repos~1.4kAutomated safety check: PassMIT
Excalidraw Diagramcoleam00/excalidraw-diagram-skill5k2 repos~6.1kAutomated safety check: PassNone

Similar skills

  • Archify Diagrams

    tt-a1i/archify

    Creates interactive architecture, workflow, sequence, data-flow and lifecycle diagrams as standalone HTML with inline SVG, themes and image or video export.

    82k GitHub stars~2.9k tokensUpdated today
    DevelopmentAuto-check passed
  • JSON Canvas

    heyitsnoah/claudesidian

    Create and edit JSON Canvas files (.canvas) with nodes, edges, groups, and connections.

    2.6k GitHub starsUsed in 18 repos~3.5k tokens
    DevelopmentAuto-check passed
  • Diagram Design

    cathrynlavery/diagram-design

    Creates branded diagrams, from architecture, flowchart and sequence to charts and maps, as self-contained HTML with inline SVG, with import from draw.io, Mermaid and Excalidraw.

    49k GitHub starsUsed in 1 repo~7.6k tokens
    DevelopmentAuto-check passed
  • Fireworks Tech Graph

    tisfeng/Easydict

    Create precise SVG technical diagrams, export PNG or offline HTML, and animate supported semantic SVGs to GIF.

    15k GitHub starsUsed in 1 repo~1.4k tokens
    DevelopmentAuto-check passed
  • Excalidraw Diagram

    coleam00/excalidraw-diagram-skill

    Create Excalidraw diagram JSON files that make visual arguments.

    5k GitHub starsUsed in 2 repos~6.1k tokens
    DevelopmentAuto-check passed
  • Draw.io Diagram Studio

    Agents365-ai/drawio-skill

    Creates and edits editable draw.io diagrams from descriptions, code, infrastructure files, SQL and API schemas, with sync, review, test and export tools.

    10k GitHub stars~2.4k tokensUpdated today
    DevelopmentAuto-check: notes

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 19 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 19 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 19 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 19 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 19 days ago
    Auto-check passed
  • Atom Ops

    Hello-QM/catgo-LRG

    One-shot recipes for adding, deleting, moving, and replacing individual atoms in the active CatGo viewer structure.

    205 GitHub stars~1.2k tokensUpdated 19 days ago
    Auto-check passed

Categories

Questions about Catgo Gibbs Pipeline

What does Catgo Gibbs Pipeline do?

Compute adsorption/reaction Gibbs free energies, free-energy diagrams, and electrochemical overpotentials (HER/ORR/OER/CO2RR/NRR) with VASP. Catgo Gibbs Pipeline is an agent skill from Hello-QM/catgo-LRG. Compute adsorption/reaction Gibbs free energies, free-energy diagrams, and electrochemical overpotentials (HER/ORR/OER/CO2RR/NRR) with VASP.

When should I use Catgo Gibbs Pipeline?

Catgo Gibbs Pipeline fits situations like: A studys target is a FREE energy (not raw DFT energy) — overpotential; free-energy diagram; ΔG of adsorption/reaction; limiting potential.

How do I install Catgo Gibbs Pipeline in Claude Code?

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

How do I install Catgo Gibbs Pipeline in Codex?

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

Can I use Catgo Gibbs Pipeline 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 catgo-gibbs-pipeline -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/catgo-gibbs-pipeline, .gemini/skills/catgo-gibbs-pipeline, .github/skills/catgo-gibbs-pipeline and .opencode/skills/catgo-gibbs-pipeline in your project.

What does Catgo Gibbs Pipeline need to run?

Going by SKILL.md and its folder, Catgo Gibbs Pipeline needs Python for the scripts in its folder. Our summary lists: Python 3.

Does Catgo Gibbs Pipeline 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 Catgo Gibbs Pipeline 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 Catgo Gibbs Pipeline use?

Catgo Gibbs Pipeline 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 Catgo Gibbs Pipeline use?

About 669 tokens (SKILL.md is roughly 2.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.4k tokens, read only when the agent opens those files.

What are the alternatives to Catgo Gibbs Pipeline?

Skills that share tags, products or a category with Catgo Gibbs Pipeline: Archify Diagrams (tt-a1i/archify, 82k stars), JSON Canvas (heyitsnoah/claudesidian, 2.6k stars), Diagram Design (cathrynlavery/diagram-design, 49k stars) and Fireworks Tech Graph (tisfeng/Easydict, 15k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Catgo Gibbs Pipeline?

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.