mat-phase-diagram

Retrieve Materials Project phase diagrams and visualize convex-hull stability.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires mp-api, pymatgen, matplotlib, monty, plotly, and includes scripts (resource) components.

What problem does it solve?

This Skill retrieves pre-computed phase diagrams from the Materials Project so you can quickly assess thermodynamic stability and competing phases without running new DFT calculations.

Core Features & Use Cases

  • Phase diagram retrieval from Materials Project: Pulls convex-hull phase diagram data for a specified chemical system (e.g., Li-O, Li-Fe-P-O).
  • Thermo-type selection (DFT dataset): Supports Materials Project thermo types including GGA_GGA+U (default), R2SCAN, and GGA.
  • Visualization output: Optionally generates and saves a plot (convex hull with stable/unstable phases) alongside the JSON data export.
  • Use-case fit: Ideal for rapid materials discovery, stability screening, and preparing inputs to follow-on analysis (e.g., checking a specific formula’s distance to the hull).

Quick Start

Use the mat-phase-diagram skill to retrieve the Li-O phase diagram by asking it to output the result as li_o_pd.json and also generate li_o_pd.png.

Frequently Asked Questions about mat-phase-diagram

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

FAQPage Schema
How do I fetch a Materials Project phase diagram for a specific chemical system?▼

The Skill retrieves pre-computed convex-hull data for a hyphen-separated chemical system like Li-O or Li-Fe-P-O. It authenticates via MP_API_KEY and outputs JSON phase-diagram data for thermodynamic stability screening.

Can I visualize the convex hull and competing phases from the Materials Project?▼

Yes, you can optionally generate and save a convex hull plot showing stable and unstable competing phases. The visualization is rendered alongside the standard JSON phase-diagram data export.

Does this phase diagram retrieval support R2SCAN thermo data or only GGA calculations?▼

It supports GGA_GGA+U (default), R2SCAN, and GGA thermo types. You can specify the desired thermo_type option to retrieve the corresponding pre-computed DFT dataset for your chemical system.

Do I need an API key to retrieve thermodynamic stability data from the Materials Project?▼

Yes, you need a valid MP_API_KEY for authentication. This key allows the Skill to securely retrieve pre-computed thermodynamic stability and convex-hull phase diagram data.

What are the limitations of using pre-computed phase diagrams for materials discovery?▼

This approach relies on existing Materials Project data for the chosen thermo_type, meaning it cannot generate phase diagrams for chemical systems where MP data is absent. It skips running new DFT calculations.

How do I calculate a specific formula's distance to the convex hull using Materials Project data?▼

Retrieve the phase diagram JSON for your chemical system to assess thermodynamic stability and competing phases. This exported data serves as the input for follow-on analysis to calculate distance to the hull.