mat-intercalation-voltage

Calculate average intercalation voltage from relaxed total energies.

144|21|Updated Jan 8, 2026
One-click install
npx skills add https://github.com/learningmatter-mit/AtomisticSkills --skill mat-intercalation-voltage
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: mat-intercalation-voltage
Source: https://github.com/learningmatter-mit/AtomisticSkills/tree/main/.agents/skills/mat-intercalation-voltage
Command: npx skills add https://github.com/learningmatter-mit/AtomisticSkills --skill mat-intercalation-voltage

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Calculate the average open-circuit voltage (OCV) of an intercalation cathode by converting relaxed total energies of the fully intercalated, de-intercalated, and bulk-metal states into an average voltage.

Core Features & Use Cases

  • Intercalation voltage computation: Computes the average OCV using the energy difference between charged (full), discharged (empty), and bulk metal reference with the appropriate chemical potential term.
  • Structure preparation workflow: Creates the de-intercalated “empty” cathode by removing intercalating ions from the fully intercalated structure.
  • MLIP-based relaxation integration: Supports relaxation of the three states via MCP MLIP tools (e.g., MACE or CHGNet) using a consistent potential across all relaxations.

Quick Start

Instruct your agent to relax the full, empty, and bulk-metal structures with the same MLIP model, then run calculate_voltage.py with the extracted energies to produce voltage_results.json.

Frequently Asked Questions about mat-intercalation-voltage

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

FAQPage Schema
How do I calculate the average intercalation voltage for a battery cathode material?▼

Calculate the average intercalation voltage by combining relaxed total energies of fully intercalated, de-intercalated, and bulk-metal reference states using an energy difference formula with a bulk chemical potential term.

What is the open-circuit voltage estimation method for Li, Na, or Mg intercalation chemistries?▼

Open-circuit voltage estimation for Li/Na/Mg/Ca/K/Zn-type intercalation chemistries uses 0 K energy differences between charged, discharged, and bulk metal states to compute an average voltage.

How do I prepare the de-intercalated empty cathode structure for voltage calculation?▼

Prepare the de-intercalated empty cathode by removing the intercalating ions from the fully intercalated structure, ensuring consistent host choices and correct n_ions counting from composition differences.

Can I use MLIP models like MACE or CHGNet for battery voltage calculation workflows?▼

Yes, MLIP models like MACE or CHGNet support battery voltage calculation workflows by relaxing the full, empty, and bulk-metal structures using a consistent potential across all relaxations.

Why do my intercalation voltage results require consistent MLIP model choices?▼

Intercalation voltage results require consistent MLIP model choices because mixing potentials across the full, empty, and bulk-metal state relaxations introduces energy inconsistencies that corrupt the voltage calculation.