Skip to content
cccskills
FreePublished on GitHub

intercalation

Use when the user asks to intercalate atoms or ions between layers, insert lithium into a cathode, or place species in interlayer gaps of a layered material.

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 (1)

  • SKILL.md5.3 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Intercalation

Overview

Intercalation inserts guest atoms or ions into the interlayer spaces of a layered host material. This is fundamental to battery electrode design, where ions shuttle between electrodes during charge/discharge cycles.

Common applications:

  • Li-ion batteries: Li intercalation in LiCoO2, LiFePO4, graphite
  • Na-ion batteries: Na intercalation in layered oxides, MXenes
  • Supercapacitors: ion insertion in MXenes, layered hydroxides
  • Catalysis: intercalated species modifying interlayer chemistry
  • 2D materials: ion intercalation in MoS2, graphite for exfoliation

MCP Tool: catgo_intercalation

{"tool": "catgo_intercalation", "arguments": {
  "structure": "<current structure dict>",
  "species": "Li",
  "position": "auto",
  "n_intercalants": 1
}}
ParameterDescriptionDefault
structureLayered host structure dict(required)
speciesIntercalant element symbol(required)
positionPlacement strategy"auto"
n_intercalantsNumber of intercalant atoms to insert1

Position Modes

ModeDescription
autoFinds the largest gap in z-fractional coordinates and inserts at the midpoint. Best default for layered materials.
tetrahedralPlaces at approximate tetrahedral interstitial sites (frac coords ~0.25).
octahedralPlaces at approximate octahedral interstitial sites (frac coords ~0.5).
customFor manual positioning (specify coordinates separately).

Router: /build/intercalation (POST)

Complete Workflow: Li Intercalation in LiCoO2

Step 1: Fetch the host structure

{"tool": "catgo_fetch", "arguments": {
  "action": "crystal", "formula": "CoO2", "source": "mp"
}}

Or fetch the fully lithiated phase:

{"tool": "catgo_fetch", "arguments": {
  "action": "crystal", "formula": "LiCoO2", "source": "mp"
}}

Step 2: Create a supercell for dilute intercalation

{"tool": "catgo_structure", "arguments": {
  "action": "supercell",
  "scaling": [2, 2, 1]
}}

Step 3: Intercalate Li

{"tool": "catgo_intercalation", "arguments": {
  "species": "Li",
  "position": "auto",
  "n_intercalants": 1
}}

For higher concentrations, increase n_intercalants. Multiple intercalants are distributed across the interlayer plane.

Step 4: Verify

{"tool": "catgo_view", "arguments": {"action": "get_state"}}

Check: Li atom is between layers, not overlapping with host atoms, reasonable interlayer distance preserved.

Step 5: Relax and compute intercalation voltage

{"tool": "catgo_workflow_engine", "arguments": {
  "action": "create", "params": {"name": "Li-CoO2 intercalation"}
}}
{"tool": "catgo_workflow_engine", "arguments": {
  "action": "add_task", "params": {
    "workflow_id": "<wf_id>",
    "task_type": "geo_opt",
    "params": {"software": "vasp", "ENCUT": 520,
               "LDAU": true, "LDAUU": {"Co": 3.32},
               "system_name": "LixCoO2 relax"}
  }
}}

Intercalation Voltage Calculation

The average intercalation voltage is:

V = -(E[Li_x2 Host] - E[Li_x1 Host] - (x2 - x1) * E[Li_metal]) / ((x2 - x1) * F)

where F is the Faraday constant. In practice:

  1. Relax the empty host (x = 0)
  2. Relax the fully intercalated structure (x = 1)
  3. Optionally relax intermediate compositions
  4. Compute V from the energy difference

Common Intercalant Species

SpeciesApplicationTypical Hosts
LiLi-ion batteriesCoO2, FePO4, MnO2, graphite, TiS2
NaNa-ion batteriesMnO2, V2O5, Prussian blue analogues
KK-ion batteriesGraphite, MoS2
MgMg batteriesV2O5, MoS2, TiS2
HProton intercalationMnO2, WO3 (electrochromics)

DFT Considerations

  • DFT+U: Required for transition metal oxides (Co, Mn, Fe, Ni). Common U values: Co (3.32 eV), Mn (3.9 eV), Fe (5.3 eV), Ni (6.2 eV).
  • Van der Waals: DFT-D3 corrections important for layered materials where interlayer bonding is weak.
  • Spin polarization: Always use ISPIN=2 for transition metal oxides.
  • K-points: Sufficient sampling in the layer plane; fewer points needed perpendicular to layers.

Common Pitfalls

  1. The auto position mode finds the largest z-gap. For materials with multiple interlayer gaps of similar size, verify the intercalant ended up in the correct gap.
  2. Always relax after intercalation. The host lattice expands to accommodate the guest species.
  3. For concentrated intercalation (multiple atoms), ensure intercalants are not placed too close together. Check with catgo_view after insertion.
  4. The host structure should be a bulk layered material, not a slab. Slabs have vacuum that will confuse the auto-positioning algorithm.
  5. Transition metal oxidation states change upon intercalation (e.g., Co4+ to Co3+ when Li is inserted). This affects magnetic moments and DFT+U parameters.
  6. For accurate voltage predictions, use the same ENCUT, k-points, and DFT+U parameters for all compositions in the voltage calculation.

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 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-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

See all skills by Hello-QM

Report a problem with this skill