cluster-ops

Place adsorbates and water layers on CatGo surfaces via MCP operations.

181|20|Updated Apr 29, 2026
One-click install
npx skills add https://github.com/Hello-QM/catgo-LRG --skill cluster-ops-hello-qm
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cluster-ops
Source: https://github.com/Hello-QM/catgo-LRG/tree/main/server/catgo/workflow/skills/structure/cluster_ops
Command: npx skills add https://github.com/Hello-QM/catgo-LRG --skill cluster-ops-hello-qm

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables deterministic, one-shot edits to a CatGo structure, replacing multi-step adsorption or layer operations with a single actionable command sequence.

Core Features & Use Cases

  • Adsorbate placement: place molecules or polyatomic adsorbates on surface sites with fixed offsets.
  • Water layer and supercell operations: build or expand solvated layers and simulation cells in one step.
  • Cluster management: merge external fragments or delete previously placed clusters using index-based operations.
  • Use Case: Place CO on a hollow site of Cu(111) and expand to a 2×2×1 supercell, or remove an incorrect adsorption cluster in one turn.

Quick Start

Instruct CatGo to place CO on a hollow site of Cu(111) at a safe height above the surface, using a single MCP call to add_molecule with query "CO" and an appropriate position offset.

Frequently Asked Questions about cluster-ops

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I place adsorbates on a surface in CatGo without running multiple steps?

Adsorbate placement on a CatGo surface is performed as a one-shot operation using a single MCP call to add_molecule with a query and a fixed position offset to place molecules on target sites.

What is the best way to expand a supercell and add water layers in CatGo workflows?

Supercell expansion and water layer construction in CatGo are executed through one-shot layer operations, allowing you to build or expand solvated layers and simulation cells in a single actionable command sequence.

Can I remove an incorrect adsorption cluster from a CatGo structure after placement?

Removing an incorrect adsorption cluster in CatGo requires index-based cluster management operations, using the delete entry point to target and eliminate previously placed fragments in one turn.

How does caching adsorption site data work for repeated CatGo structure edits?

Caching adsorption site data in CatGo workflows stores surface site analysis results to prevent redundant calculations, enabling deterministic one-shot edits when placing multiple adsorbates or modifying layers.

Does the adsorbate placement workflow support merging external fragments into a CatGo supercell?

Merging external fragments into a CatGo supercell is supported through the merge entry point, utilizing index-based cluster management to combine external structures with existing surface models.

What are the limitations of using one-shot operations for adsorbate placement in CatGo?

One-shot adsorption operations in CatGo rely on a single MCP entry point and require pre-calculated position offsets, meaning precise site coordinates and cached adsorption data must be prepared before execution.