Agent skill

Surface Catalysis

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

A skill your agent uses when the user asks about surface slabs, Miller indices, adsorbate placement, adsorption sites, water layers, passivation, heterostructures, lattice matching, moire bilayers…

AGPL-3.0Auto-check passed

Install Surface Catalysis

skills CLI
$ npx skills add Hello-QM/catgo-LRG --skill surface-catalysis -a claude-code

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

GitHub CLI
$ gh skill install Hello-QM/catgo-LRG surface-catalysis --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/catbot-plugin/skills/surface-catalysis .claude/skills/surface-catalysis && 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
surface-catalysis
GitHub stars
205
Token cost
~609 tokens
SKILL.md length
232 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 about surface slabs, Miller indices, adsorbate placement, adsorption sites, water layers, passivation, heterostructures, lattice matching, moire bilayers…

  • Works in 3 steps: Start with a bulk crystal (fetch or use… → catgo_generate_slab with miller_index as… → Inspect result with catgo_structure_info
  • The user asks about surface slabs
  • SKILL.md covers Surface Slab Generation, Adsorbate Placement, Surface Passivation and Water Layer, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Surface Catalysis is an agent skill from Hello-QM/catgo-LRG. Use when the user asks about surface slabs, Miller indices, adsorbate placement, adsorption sites, water layers, passivation, heterostructures, lattice matching, moire bilayers, or catalysis workflows.

Its SKILL.md is about 610 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 about surface slabs
  • Adsorbate placement
  • Adsorption sites
  • Heterostructures

Example prompts

  • “/surface-catalysis”

Workflow steps

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

  1. Start with a bulk crystal (fetch or use current)
  2. catgo_generate_slab with miller_index as [h, k, l]
  3. Inspect result with catgo_structure_info

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.

    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

Surface Catalysis loads about 609 tokens when it runs. Until then it costs about 55 tokens; SKILL.md has 232 words of instructions outside code blocks.

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

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). 232 words, ~609 tokens.

Download SKILL.mdSave it as .claude/skills/surface-catalysis/SKILL.md (or your agent's skills folder).
name
surface-catalysis
description
Use when the user asks about surface slabs, Miller indices, adsorbate placement, adsorption sites, water layers, passivation, heterostructures, lattice matching, moire bilayers, or catalysis workflows.

Surface & Catalysis Workflow

Surface Slab Generation

  1. Start with a bulk crystal (fetch or use current)
  2. catgo_generate_slab with miller_index as [h, k, l]
    • Defaults: min_slab_size=10.0 A, min_vacuum_size=15.0 A
    • Returns all symmetrically distinct terminations
  3. Inspect result with catgo_structure_info

Miller index selection:

SurfaceMiller IndexCommon Use
FCC (111)[1,1,1]Close-packed, catalysis
FCC (100)[1,0,0]Open surface
BCC (110)[1,1,0]Close-packed
Rutile (110)[1,1,0]TiO2 catalysis
Perovskite (001)[0,0,1]ABO3 surfaces

Adsorbate Placement

  1. catgo_adsorption_sites — Find top, bridge, hollow sites. height default 2.0 A.
  2. catgo_adsorption_place — Place adsorbate at chosen site coordinates.

Get adsorbate molecules via catgo_fetch_molecule:

  • CO, CO2, H2O, NH3, O2, CH4, etc.

Surface Passivation

catgo_passivate — Cap dangling bonds with pseudo-hydrogen on slab bottom surface. Requires both slab and bulk reference structure dicts.

Water Layer

catgo_water_layer — Add TIP4P water layer for solid/liquid interface models. Parameters: z_start, z_end, min_distance (overlap removal), equilibrate (optional LAMMPS).

Heterostructure & Interface

ZSL Lattice Matching (Two-Step)
  1. catgo_hetero_search — Find lattice-matched substrate/film pairs
  2. catgo_hetero_build — Build interface from selected match
One-Step Interface

catgo_hetero_build_intermat — Simpler pipeline, less control but faster prototyping.

Moire Bilayer

  1. catgo_moire_search — Find commensurate twist angles with supercell sizes
  2. catgo_moire_build — Build bilayer at selected angle

Complete Catalysis Recipe

  1. catgo_fetch_crystal (bulk, e.g. Pt)
  2. catgo_generate_slab (miller_index=[1,1,1], min_slab_size=12, min_vacuum_size=15)
  3. catgo_passivate (bottom surface)
  4. catgo_adsorption_sites (find sites)
  5. catgo_fetch_molecule (get adsorbate)
  6. catgo_adsorption_place (place at chosen site)
  7. catgo_structure_info (verify)
  8. Generate DFT input (see computational-input skill)

© 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 catbot-plugin/skills/surface-catalysis of Hello-QM/catgo-LRG.

Open the folder on GitHubat commit fd6291b

Compare with similar skills

Surface Catalysis 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.

Surface Catalysis compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Surface Catalysis this skillHello-QM/catgo-LRG205—~609Automated safety check: PassAGPL-3.0
Workspace Surface Auditaffaan-m/ECC275k3 repos~1.3kAutomated safety check: NotesMIT
Loading Indicatorsthedaviddias/Front-End-Checklist74k—~434Automated safety check: PassMIT
Surfacesrid/emanote963—~1.5kAutomated safety check: PassCustom licence
Workspace Surface Auditaffaan-m/ECC275k—~761Automated safety check: NotesMIT
Workspace Surface Auditaffaan-m/ECC275k—~558Automated safety check: NotesMIT

Similar skills

  • Audit the active repo, MCP servers, plugins, connectors, env surfaces, and harness setup, then recommend the highest-value ECC-native skills, hooks, agents, and operator workflows.

    275k GitHub starsUsed in 3 repos~1.3k tokens
    Agent WorkflowsAuto-check: notes
  • Loading Indicators

    thedaviddias/Front-End-Checklist

    A skill your agent uses when auditing slow page loads, heavy assets, or rendering delays related to Show loading indicators.

    74k GitHub stars~434 tokensUpdated 2 days ago
    Frontend & DesignAuto-check passed
  • Surface

    srid/emanote

    How a downstream app consumes the shared @kolu/surface stack (@kolu/surface · surface-app · surface-nix-host · surface-mcp) — declaring a typed reactive surface, serving it, consuming it (SolidJS…

    963 GitHub stars~1.5k tokensUpdated 2 mo ago
    Auto-check passed
  • アクティブなリポジトリ、MCPサーバー、プラグイン、コネクター、環境サーフェス、ツールのセットアップを監査し、最も価値の高いECCネイティブスキル、フック、エージェント、オペレーターワークフローを推奨する。ユーザーがClaude Codeのセットアップを支援してほしい場合や、環境で実際に何が使えるかを理解したい場合に使用する。

    275k GitHub stars~761 tokensUpdated 3 days ago
    Agent WorkflowsAuto-check: notes
  • 审计活跃仓库、MCP服务器、插件、连接器、环境表面和工具设置,然后推荐最高价值的ECC原生技能、钩子、代理和操作员工作流。当用户希望帮助设置Claude Code或了解其环境中实际可用的功能时使用。

    275k GitHub stars~558 tokensUpdated 3 days ago
    Agent WorkflowsAuto-check: notes
  • Hunting For Spearphishing Indicators

    mukul975/Anthropic-Cybersecurity-Skills

    Hunt for spearphishing campaign indicators across email logs, endpoint telemetry, and network data to detect targeted email attacks.

    34k GitHub stars~1k 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 16 days ago
    Auto-check passed
  • Lammps Deepmd

    Hello-QM/catgo-LRG

    Run LAMMPS molecular dynamics with DeePMD-kit machine learning potentials.

    205 GitHub starsUsed in 1 repo~1k tokens
    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 16 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 16 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 16 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 16 days ago
    Auto-check passed

Questions about Surface Catalysis

What does Surface Catalysis do?

A skill your agent uses when the user asks about surface slabs, Miller indices, adsorbate placement, adsorption sites, water layers, passivation, heterostructures, lattice matching, moire bilayers…. Surface Catalysis is an agent skill from Hello-QM/catgo-LRG. Use when the user asks about surface slabs, Miller indices, adsorbate placement, adsorption sites, water layers, passivation, heterostructures, lattice matching, moire bilayers, or catalysis workflows.

When should I use Surface Catalysis?

Surface Catalysis fits situations like: the user asks about surface slabs; adsorbate placement; adsorption sites; heterostructures.

How do I install Surface Catalysis in Claude Code?

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

How do I install Surface Catalysis in Codex?

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

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

What does Surface Catalysis need to run?

SKILL.md names no scripts, command-line tools or credentials: Surface Catalysis is instructions for the agent only.

Does Surface Catalysis 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 Surface Catalysis 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 Surface Catalysis use?

Surface Catalysis 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 Surface Catalysis use?

About 609 tokens (SKILL.md is roughly 2.4k 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 Surface Catalysis?

Skills that share tags, products or a category with Surface Catalysis: Workspace Surface Audit (affaan-m/ECC, 275k stars), Loading Indicators (thedaviddias/Front-End-Checklist, 74k stars), Surface (srid/emanote, 963 stars) and Workspace Surface Audit (affaan-m/ECC, 275k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Surface Catalysis?

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.