Agent skill

Vasp Band

by Hello-QM in Hello-QM/catgo-LRG

VASP band structure calculation. An agent skill from Hello-QM/catgo-LRG.

AGPL-3.0Auto-check passed

Install Vasp Band

skills CLI
$ npx skills add Hello-QM/catgo-LRG --skill vasp-band -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Hello-QM/catgo-LRG vasp-band --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Hello-QM/catgo-LRG.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/vasp-band .claude/skills/vasp-band && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
vasp-band
GitHub stars
205
Token cost
~1.7k tokens
SKILL.md length
320 words
Files
1
Skills in repo
75
Repo updated
First seen
Licence
AGPL-3.0

At a glance

VASP band structure calculation. An agent skill from Hello-QM/catgo-LRG.

  • Works in 2 steps: Single point (SCF) — compute… → Band calculation (non-SCF) — read the…
  • SKILL.md covers Why Two Steps?, Full Band Structure Workflow, MCP Workflow and High-Symmetry K-Path, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Vasp Band is an agent skill from Hello-QM/catgo-LRG. VASP band structure calculation. Two-step workflow with SCF charge density followed by non-SCF band calculation along high-symmetry k-path.

Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: AI-driven workbench for computational materials science — interactive 3D structure viewer, natural-language CatBot assistant, visual DAG workflow engine, HPC job submission… The licence is AGPL-3.0.

Example prompts

  • “/vasp-band”

Requirements

  • Python 3

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

  1. Single point (SCF) — compute self-consistent charge density with a uniform k-mesh
  2. Band calculation (non-SCF) — read the converged CHGCAR and compute eigenvalues along the high-symmetry k-path without updating the charge…

What it can do on your machine

Read from SKILL.md and the folder at commit fd6291b. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are python).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Vasp Band loads about 1.7k tokens when it runs. Until then it costs about 37 tokens; SKILL.md has 320 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~37
When it runs · the whole SKILL.md, loaded when a task matches
~1.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Hello-QM/catgo-LRG at commit fd6291b, republished under its AGPL-3.0 licence (© Hello-QM). 320 words, ~1,657 tokens.

Download SKILL.mdSave it as .claude/skills/vasp-band/SKILL.md (or your agent's skills folder).
name
vasp-band
description
VASP band structure calculation. Two-step workflow with SCF charge density followed by non-SCF band calculation along high-symmetry k-path.

VASP Band Structure Calculation

Compute electronic band structure along high-symmetry k-point paths. Requires a two-step process: self-consistent charge density, then non-SCF calculation along the k-path.

Why Two Steps?

  1. Single point (SCF) — compute self-consistent charge density with a uniform k-mesh
  2. Band calculation (non-SCF) — read the converged CHGCAR and compute eigenvalues along the high-symmetry k-path without updating the charge density

This separation is necessary because the high-symmetry k-path does not provide uniform Brillouin zone sampling needed for SCF convergence.

Full Band Structure Workflow

python
from catgo.workflow import Workflow
from catgo.workflow.builtins import geo_opt, single_point

wf = Workflow("TiO2 band structure")
struct = wf.add_task("structure_input", structure=structure_json)

# Step 1: Optimize (skip if already relaxed)
opt = wf.add_task(geo_opt, structure=struct.output.structure,
                  ISIF=3, system_name="relax")

# Step 2: SCF single point to generate CHGCAR
scf = wf.add_task(single_point, structure=opt.output.structure,
                  LCHARG=True,     # Write CHGCAR
                  EDIFF=1e-6,      # Tight convergence
                  system_name="SCF")

# Step 3: Non-SCF band calculation
band = wf.add_task(single_point, structure=opt.output.structure,
                   ICHARG=11,       # Read CHGCAR, do not update
                   LORBIT=11,       # Projected band character
                   LCHARG=False,
                   LWAVE=False,
                   kpath_mode="auto",  # Auto-detect high-symmetry path
                   kpath_density=40,   # Points per segment
                   system_name="bands")

wf.submit()

MCP Workflow

catgo_workflow_engine(action="create", params={"name": "Band structure"})

# Input structure
catgo_workflow_engine(action="add_task", params={
  "workflow_id": "wf_xxx",
  "task_type": "structure_input",
  "structure": "<json>"
})

# SCF single point
catgo_workflow_engine(action="add_task", params={
  "workflow_id": "wf_xxx",
  "task_type": "single_point",
  "software": "vasp",
  "structure": "{{t_001.output.structure}}",
  "LCHARG": true,
  "EDIFF": 1e-6,
  "system_name": "SCF"
})

# Non-SCF band calculation
catgo_workflow_engine(action="add_task", params={
  "workflow_id": "wf_xxx",
  "task_type": "single_point",
  "software": "vasp",
  "structure": "{{t_001.output.structure}}",
  "ICHARG": 11,
  "LORBIT": 11,
  "kpath_mode": "auto",
  "kpath_density": 40,
  "system_name": "bands"
})

catgo_workflow_engine(action="submit", params={"workflow_id": "wf_xxx"})

High-Symmetry K-Path

Automatic Path Detection

Set kpath_mode="auto" to let the engine detect the Bravais lattice and generate the standard k-path. This works for most crystal systems.

Manual K-Path

For custom paths, specify k-points explicitly:

python
band = wf.add_task(single_point, structure=opt.output.structure,
                   ICHARG=11,
                   kpath_mode="manual",
                   kpath_points={
                       "G": [0.0, 0.0, 0.0],
                       "X": [0.5, 0.0, 0.0],
                       "M": [0.5, 0.5, 0.0],
                       "G2": [0.0, 0.0, 0.0],
                       "R": [0.5, 0.5, 0.5],
                   },
                   kpath_segments=["G-X", "X-M", "M-G2", "G2-R"],
                   kpath_density=40,
                   system_name="bands")
Common K-Paths by Crystal System
SystemPathExample
FCCG-X-W-K-G-L-U-W-L-KCu, Al, Pt
BCCG-H-N-G-P-HFe, W, Cr
HCPG-M-K-G-A-L-H-ATi, Ru, Co
TetragonalG-X-M-G-Z-R-A-ZTiO2 rutile
Simple cubicG-X-M-G-R-XSrTiO3

Key Parameters

ParameterValuePurpose
ICHARG11Read CHGCAR, non-self-consistent
LORBIT11Atom- and orbital-projected bands
NBANDSautoNumber of bands (increase for unoccupied states)
LCHARGFalseDo not overwrite CHGCAR from SCF step
LWAVEFalseDo not write WAVECAR (saves disk)
kpath_density40K-points per segment (more = smoother bands)

Spin-Polarized Band Structure

For magnetic systems:

python
scf = wf.add_task(single_point, structure=s,
                  LCHARG=True, ISPIN=2,
                  MAGMOM="2*5.0 4*0.6",
                  system_name="SCF_spin")

band = wf.add_task(single_point, structure=s,
                   ICHARG=11, ISPIN=2, LORBIT=11,
                   kpath_mode="auto", kpath_density=40,
                   system_name="bands_spin")

Hybrid Functional Band Structure (HSE06)

HSE06 band structure is expensive but more accurate for band gaps:

python
scf = wf.add_task(single_point, structure=s,
                  LCHARG=True, LHFCALC=True, HFSCREEN=0.2,
                  AEXX=0.25, ALGO="Damped", TIME=0.4,
                  system_name="SCF_HSE")

band = wf.add_task(single_point, structure=s,
                   ICHARG=11, LHFCALC=True, HFSCREEN=0.2,
                   AEXX=0.25, ALGO="Damped", TIME=0.4,
                   kpath_mode="auto", kpath_density=20,
                   system_name="bands_HSE")

Note: HSE band calculations are 10-100x more expensive than PBE. Use a lower kpath_density (20) and fewer NBANDS.

Combined DOS + Band Structure

Run both from the same SCF calculation:

python
scf = wf.add_task(single_point, structure=opt.output.structure,
                  LCHARG=True, EDIFF=1e-6, system_name="SCF")

# DOS branch
dos_sp = wf.add_task(single_point, structure=opt.output.structure,
                     ISMEAR=-5, NEDOS=3001, LORBIT=11,
                     system_name="DOS")

# Band branch
band = wf.add_task(single_point, structure=opt.output.structure,
                   ICHARG=11, LORBIT=11,
                   kpath_mode="auto", kpath_density=40,
                   system_name="bands")

Troubleshooting

ProblemFix
Bands look wrong / discontinuousCHGCAR from SCF may be on different k-mesh. Ensure SCF used uniform mesh
Band gap too small (PBE)Expected — PBE underestimates gaps. Use HSE06 for accurate gaps
Missing unoccupied bandsIncrease NBANDS (default may cut off conduction bands)
ICHARG=11 errorCHGCAR must exist from SCF step. Check SCF completed with LCHARG=True
Very slow HSENormal — reduce kpath_density, reduce NBANDS, use more nodes

© Hello-QM, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills/vasp-band of Hello-QM/catgo-LRG.

Open the folder on GitHubat commit fd6291b

Compare with similar skills

Vasp Band next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Vasp Band compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Vasp Band this skillHello-QM/catgo-LRG205—~1.7kAutomated safety check: PassAGPL-3.0
Eol Resistor Calculatorsickn33/agentic-awesome-skills47k1 repos~3.5kAutomated safety check: PassMIT
Bandjinzhezenggroup/computational-chemistry-agent-skills148—~411Automated safety check: PassLGPL-3.0-or-later
Metric Calculatorjeremylongshore/tons-of-skills-marketplace2.8k—~563Automated safety check: PassMIT
Retention Calculatorjeremylongshore/tons-of-skills-marketplace2.8k—~573Automated safety check: PassMIT
Throughput Calculatorjeremylongshore/tons-of-skills-marketplace2.8k—~577Automated safety check: PassMIT

Similar skills

  • Eol Resistor Calculator

    sickn33/agentic-awesome-skills

    Calculates and validates end-of-line (EOL, SEOL, DEOL, TEOL) resistor loops for intrusion alarm panels (Honeywell, DSC, Paradox, Bosch) with wire gauge drop and state tables.

    47k GitHub starsUsed in 1 repo~3.5k tokens
    Auto-check passed
  • Band

    jinzhezenggroup/computational-chemistry-agent-skills

    Prepare VASP band-structure workflow inputs from existing SCF context and user-specified band-path settings.

    148 GitHub stars~411 tokensUpdated 2 days ago
    Auto-check passed
  • Metric Calculator

    jeremylongshore/tons-of-skills-marketplace

    Configure and manage - Calculate metric calculator operations.

    2.8k GitHub stars~563 tokensUpdated yesterday
    Product & Project ManagementAuto-check passed
  • Retention Calculator

    jeremylongshore/tons-of-skills-marketplace

    Configure and manage - Calculate retention calculator operations.

    2.8k GitHub stars~573 tokensUpdated yesterday
    Data & AnalyticsAuto-check passed
  • Throughput Calculator

    jeremylongshore/tons-of-skills-marketplace

    Calculate throughput calculator operations. An agent skill from jeremylongshore/tons-of-skills-marketplace.

    2.8k GitHub stars~577 tokensUpdated yesterday
    Testing & QAAuto-check passed
  • Calculator

    Code-and-Sorts/awesome-copilot-agents

    Performs arbitrary-precision arithmetic calculations including addition, subtraction, multiplication, division, and exponents.

    580 GitHub starsUsed in 1 repo~470 tokens
    Auto-check passed

More from Hello-QM/catgo-LRG

All 75 skills in this repo
  • Campaign Md Orchestration

    Hello-QM/catgo-LRG

    Drive a file-first, agent-in-the-loop computational campaign via a folder + markdown tree (no DB).

    205 GitHub stars~1.6k tokensUpdated 19 days ago
    Auto-check passed
  • Catgo Gibbs Pipeline

    Hello-QM/catgo-LRG

    Compute adsorption/reaction Gibbs free energies, free-energy diagrams, and electrochemical overpotentials (HER/ORR/OER/CO2RR/NRR) with VASP.

    205 GitHub stars~669 tokensUpdated 19 days ago
    Auto-check passed
  • Abinit

    Hello-QM/catgo-LRG

    Generate and manage ABINIT DFT calculations. An agent skill from Hello-QM/catgo-LRG.

    205 GitHub stars~963 tokensUpdated 19 days ago
    Auto-check passed
  • Adsorbate Placement

    Hello-QM/catgo-LRG

    A skill your agent uses when the user asks to place an adsorbate molecule on a surface, find adsorption sites, or set up a surface+adsorbate model for DFT.

    205 GitHub stars~3k tokensUpdated 19 days ago
    Auto-check passed
  • Adsorption Energy

    Hello-QM/catgo-LRG

    A skill your agent uses when the user asks for adsorption energy, binding energy, or wants to compare how strongly a molecule binds to a surface.

    205 GitHub stars~1.4k tokensUpdated 19 days ago
    Auto-check passed
  • Analysis Router

    Hello-QM/catgo-LRG

    A skill your agent uses 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…

    205 GitHub stars~869 tokensUpdated 19 days ago
    Auto-check passed

Questions about Vasp Band

What does Vasp Band do?

VASP band structure calculation. An agent skill from Hello-QM/catgo-LRG. Vasp Band is an agent skill from Hello-QM/catgo-LRG. VASP band structure calculation.

How do I install Vasp Band in Claude Code?

Run `npx skills add Hello-QM/catgo-LRG --skill vasp-band -a claude-code`. Or copy the skill folder (.claude/skills/vasp-band in Hello-QM/catgo-LRG) into .claude/skills/vasp-band in your project. Claude Code loads it when a task matches its description.

How do I install Vasp Band in Codex?

Run `npx skills add Hello-QM/catgo-LRG --skill vasp-band -a codex`. Or copy the skill folder (.claude/skills/vasp-band in Hello-QM/catgo-LRG) into .agents/skills/vasp-band in your project. Codex loads it when a task matches its description.

Can I use Vasp Band in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Hello-QM/catgo-LRG --skill vasp-band -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/vasp-band, .gemini/skills/vasp-band, .github/skills/vasp-band and .opencode/skills/vasp-band in your project.

What does Vasp Band need to run?

SKILL.md names no scripts, command-line tools or credentials: Vasp Band is instructions for the agent only. Our summary lists: Python 3.

Does Vasp Band access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Vasp Band safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Vasp Band use?

Vasp Band is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Vasp Band use?

About 1.7k tokens (SKILL.md is roughly 6.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Vasp Band?

Skills that share tags, products or a category with Vasp Band: Eol Resistor Calculator (sickn33/agentic-awesome-skills, 47k stars), Band (jinzhezenggroup/computational-chemistry-agent-skills, 148 stars), Metric Calculator (jeremylongshore/tons-of-skills-marketplace, 2.8k stars) and Retention Calculator (jeremylongshore/tons-of-skills-marketplace, 2.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Vasp Band?

Hello-QM (a GitHub user) maintains it in Hello-QM/catgo-LRG, which has 205 GitHub stars. The repository holds 75 skills in this directory. The repository was last updated on September 22, 2026.

Source: Hello-QM/catgo-LRG on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.