Skip to content

Hello-QM/catgo-LRG / catbot-plugin/skills/structure-builder

structure-builder

Verified

Use when the user asks to load, fetch, build, modify, or transform crystal/molecular structures. Covers database import, supercell, defects, doping, intercalation, nanotubes, and atom-level editing.

Structure Builder

Loading Structures

From Online Databases

  • catgo_fetch_crystal — Load crystal by formula or structure_id from OPTIMADE providers (mp=Materials Project, mc3d, alexandria, twodmatpedia, omdb)
  • catgo_search_crystals — Search and list multiple matches. Use this first when browsing, then catgo_fetch_crystal with a specific structure_id.
  • catgo_fetch_molecule — Fetch molecules from PubChem by name, formula, or SMILES.

Provider heuristics:

  • General inorganic crystals: mp (largest database)
  • 2D materials: twodmatpedia
  • Organic molecules: use catgo_fetch_molecule, not OPTIMADE

From Current Viewer

Call catgo_structure_info to inspect the loaded structure. All structure-modifying tools auto-fetch the current viewer structure — no need to pass structure dicts.

Atom-Level Operations

ToolUse When
catgo_add_atom / catgo_add_atomsAdding atoms at Cartesian positions (Angstroms)
catgo_delete_atomsRemoving atoms by 0-based index
catgo_replace_atomChanging element at a site
catgo_move_atom / catgo_move_atomsRepositioning atoms

Lattice and Cell Operations

ToolUse When
catgo_supercellExpanding unit cell by [na, nb, nc] or 3x3 matrix
catgo_set_latticeAdding/changing periodic cell (wraps molecules in a box)
catgo_mergeCombining two structures at a given position

Defect Engineering

ToolUse When
catgo_build_defectPoint defects: vacancy, substitution, interstitial
catgo_dopingSubstitutional doping (replace host with dopant)
catgo_substitutionCombinatorial multi-site substitution
catgo_intercalationInsert species (Li, Na) into layered structures
catgo_build_strainApply strain/deformation (Voigt notation or 3x3 matrix)

Nanostructures

ToolUse When
catgo_nanotube_buildCarbon or BN nanotubes from chiral indices (n, m)
catgo_nanotube_infoCompute nanotube geometry before building

Common Recipes

Doped supercell

  1. catgo_fetch_crystal → 2. catgo_supercell → 3. catgo_doping → 4. catgo_structure_info

Defective structure for DFT

  1. Fetch bulk → 2. catgo_supercell (large enough to avoid defect-defect interaction) →
  2. catgo_build_defect → 4. catgo_structure_info

Intercalated battery material

  1. catgo_fetch_crystal (e.g. MoS2) → 2. catgo_intercalation (species="Li") → 3. Verify
deprecation-and-migrationaddyosmani/agent-skillsManages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when migrating a database schema in production, such as renaming or dropping a column without downtime (expand/contract). Use when deciding whether to maintain or sunset existing code.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
performance-optimizationaddyosmani/agent-skillsOptimizes application performance across frontend, backend, queries, and databases. Use when performance requirements exist, when you suspect performance regressions, when Core Web Vitals or load times need improvement, when N+1 query patterns need fixing, or when profiling reveals bottlenecks.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
Agent Cost Reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
Agent Cost Reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json.Stars: 118kUpdated Claude CodeCodexVerifiedInstall