Skip to content
cccskills
FreePublished on GitHub

analysis-router

Use 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 charge analysis.

The English summary is being prepared. Showing the original description.

Hello-QM/catgo-LRG208 stars(GitHub 208 + cccskills 0)

Run score Not tested

See how to install

Files included (17)

  • SKILL.md3.4 KB
  • adsorption/SKILL.md5.5 KB
  • charge/SKILL.md5.5 KB
  • co2rr/SKILL.md8.8 KB
  • cohp/SKILL.md5.3 KB
  • convergence/SKILL.md5.6 KB
  • dos_analysis/SKILL.md5.6 KB
  • energy_diagram/SKILL.md7.1 KB
  • gibbs/SKILL.md5.8 KB
  • her/SKILL.md6.8 KB
  • mace_ni_benchmark/README.md5.1 KB
  • mace_ni_benchmark/SKILL.md5.0 KB
  • nrr/SKILL.md7.7 KB
  • oer/SKILL.md7.1 KB
  • phonopy/SKILL.md5.5 KB
  • reacnetgen/SKILL.md4.5 KB
  • volcano/SKILL.md5.3 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Analysis Router

This skill routes analysis requests to the correct sub-skill based on what the user is asking for.

Routing Table

User IntentSub-SkillKey Indicators
Gibbs free energy, ZPE, thermal correctionsgibbs/"free energy", "ZPE", "entropy", "thermal"
OER overpotentialoer/"OER", "oxygen evolution", "water splitting anode"
HER overpotentialher/"HER", "hydrogen evolution", "water splitting cathode"
CO2 reductionco2rr/"CO2RR", "CO2 reduction", "carbon dioxide"
Adsorption energyadsorption/"adsorption energy", "binding energy", "E_ads"
ENCUT/KPOINTS convergenceconvergence/"convergence", "ENCUT test", "k-point test"
DOS, d-band center, PDOSdos_analysis/"DOS", "d-band", "PDOS", "density of states"
Bader chargecharge/"Bader", "charge transfer", "charge analysis"
MACE Ni benchmark (Kreitz 2021)mace_ni_benchmark/"Kreitz", "MACE Ni benchmark", "MLP vs DFT-D3 on Ni"

MCP Tool: catgo_analyze

All analysis actions use the catgo_analyze tool with an action parameter.

{"tool": "catgo_analyze", "arguments": {"action": "convergence", ...}}
{"tool": "catgo_analyze", "arguments": {"action": "frequencies", ...}}
{"tool": "catgo_analyze", "arguments": {"action": "forces", ...}}

MCP Tool: catgo_workflow_engine

Most analysis workflows are built as DAGs using the workflow tool.

{"tool": "catgo_workflow_engine", "arguments": {"action": "create", "name": "Analysis WF"}}
{"tool": "catgo_workflow_engine", "arguments": {"action": "add_task", "workflow_id": "...", "task_type": "gibbs_energy", ...}}

Python API Pattern

All analysis workflows follow the same skeleton:

from catgo.workflow import Workflow

wf = Workflow("Analysis name")

# 1. Input structure
inp = wf.add_task("structure_input", structure=structure_json)

# 2. Compute (geo_opt, single_point, freq, etc.)
opt = wf.add_task("geo_opt", structure=inp.output.structure, software="vasp")
frq = wf.add_task("freq", structure=opt.output.structure, software="vasp",
                   freeze_mode="layers", freeze_layers=4)

# 3. Analyze (gibbs_energy, dos_analysis, charge_analysis, etc.)
gib = wf.add_task("gibbs_energy", energy=opt.output.energy,
                   frequencies=frq.output.frequencies, phase="adsorbed")

wf.submit()

Decision Guide

  • Single intermediate (H*, OH) --> her/, adsorption/
  • Multiple intermediates in reaction pathway --> oer/, co2rr/
  • Parameter sweep, no reaction --> convergence/
  • Post-processing existing calculation --> dos_analysis/, charge/
  • Converting DFT energy to thermodynamic quantity --> gibbs/

Common Pitfalls

  1. Always run geo_opt before freq -- frequencies on unrelaxed structures are meaningless.
  2. For surface calculations, always use freeze_mode="layers" in freq to avoid imaginary frequencies from slab bottom atoms.
  3. Gibbs energy needs both energy (from geo_opt) and frequencies (from freq) -- these come from separate tasks connected via output references.
  4. Convergence tests use single_point (not geo_opt) to isolate the parameter effect.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

abinit

Free

Generate and manage ABINIT DFT calculations. Use when the user requests ABINIT, or needs DFPT phonons, GW calculations, or BSE optical spectra.

The English summary is being prepared. Showing the original description.

Hello-QM/catgo-LRG208Updated Oct 23, 2026

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

The English summary is being prepared. Showing the original description.

Hello-QM/catgo-LRG208Updated Oct 23, 2026

Use when the user asks for adsorption energy, binding energy, or wants to compare how strongly a molecule binds to a surface.

The English summary is being prepared. Showing the original description.

Hello-QM/catgo-LRG208Updated Oct 23, 2026

Use AmberTools antechamber for molecular force field parameterization. Generates GAFF/GAFF2 parameters and AM1-BCC or RESP charges for use in AMBER or LAMMPS classical MD simulations.

The English summary is being prepared. Showing the original description.

Hello-QM/catgo-LRG208Updated Oct 23, 2026

One-shot recipes for adding, deleting, moving, and replacing individual atoms in the active CatGo viewer structure. Use whenever the user asks to "add an atom", "delete atoms", "remove this atom", "move atom N", "replace H with Li", or any single-atom edit — including "add a hydrogen on top of atom 12" / "delete atoms 5–9" / "swap the oxygen at site 3 for fluorine". Skips the discovery loop (no need to list structure tools or check adsorption sites first); goes straight to the matching `catgo_structure` action. Triggers in Chinese on 加原子, 删原子, 减原子, 移动原子, 替换原子, 增加氢, 删除氧, 把 ... 换成 ....

The English summary is being prepared. Showing the original description.

Hello-QM/catgo-LRG208Updated Oct 23, 2026

Diagnose and fix the CatGo backend. Use whenever the user asks to "check the backend", "diagnose the backend", "fix the backend", "why isn't X working", reports connection problems, a blank/failing UI, "router not loaded", "deps missing", or "can't reach the server". Reads GET /api/diagnostics, explains each issue from its fix_hint, auto-applies SAFE fixes (reconnect HPC, pip install a missing dep via the terminal), confirms risky actions first, and — if diagnostics itself is unreachable — tells the user how to start the backend instead of pretending to fix one that is down.

The English summary is being prepared. Showing the original description.

Hello-QM/catgo-LRG208Updated Oct 23, 2026

See all skills by Hello-QM

Report a problem with this skill