Convert and manipulate atomic simulation data formats using dpdata CLI.

LGPL-3.0Auto-check passed

Install Dpdata CLI

skills CLI
$ npx skills add jinzhezenggroup/computational-chemistry-agent-skills --skill dpdata-cli -a claude-code

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

GitHub CLI
$ gh skill install jinzhezenggroup/computational-chemistry-agent-skills dpdata-cli --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/jinzhezenggroup/computational-chemistry-agent-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/tools/dpdata-cli .claude/skills/dpdata-cli && 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
dpdata-cli
GitHub stars
148
Token cost
~2.6k tokens
SKILL.md length
604 words
Files
2
Skills in repo
62
Repo updated
First seen
Licence
LGPL-3.0

At a glance

Convert and manipulate atomic simulation data formats using dpdata CLI.

  • Works in 3 steps: Use -i extxyz explicitly when working… → Use --multi for any multi-frame extxyz… → All alias names behave identically — -i…
  • Converting between DFT/MD output formats
  • SKILL.md covers Quick Start, Command Line Usage, Common Examples and Supported Formats, plus 2 more sections
  • Calls uvx

What it does

Dpdata CLI is an agent skill from jinzhezenggroup/computational-chemistry-agent-skills. Convert and manipulate atomic simulation data formats using dpdata CLI. Use when converting between DFT/MD output formats or preparing DeePMD-kit training data. Supports 50+ formats including deepmd, xyz or extxyz, ABACUS, VASP, LAMMPS, CP2K, etc.

Its SKILL.md is about 2.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `README.md`). Compatibility notes: Requires uvx (uv) for running dpdata

The repository describes itself as: Agent skills to run computational-chemistry tasks, used in OpenClaw. The licence is LGPL-3.0.

When your agent uses it

  • Converting between DFT/MD output formats
  • Preparing DeePMD-kit training data

Example prompts

  • “/dpdata-cli”

Requirements

  • Compatibility (from SKILL.md): Requires uvx (uv) for running dpdata

Workflow steps

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

  1. Use -i extxyz explicitly when working with .xyz files that contain extended XYZ data. Using -i xyz retains only atom species and…
  2. Use --multi for any multi-frame extxyz file. Without --multi, the CLI constructs a LabeledSystem that keeps only the first frame. This…
  3. All alias names behave identically — -i mace/xyz, -i nequip/xyz, -i gpumd/xyz, -i quip/gap/xyz, -i quip/gap/xyz_file, and -i extxyz…

What it can do on your machine

Read from SKILL.md and the folder at commit 5c19e75. 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

    Shell commands in SKILL.md call:

    • uvx

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

  • Network

    Links to these hosts (documentation or services it may open):

    • docs.deepmodeling.com
    • github.com

    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.

  • Compatibility

    Requires uvx (uv) for running dpdata

    From compatibility in the SKILL.md frontmatter.

Context cost

Dpdata CLI loads about 2.6k tokens when it runs. Until then it costs about 65 tokens; SKILL.md has 604 words of instructions outside code blocks.

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

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 jinzhezenggroup/computational-chemistry-agent-skills at commit 5c19e75, republished under its LGPL-3.0 licence (© jinzhezenggroup). 604 words, ~2,555 tokens.

Download SKILL.mdSave it as .claude/skills/dpdata-cli/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
dpdata-cli
description
Convert and manipulate atomic simulation data formats using dpdata CLI. Use when converting between DFT/MD output formats or preparing DeePMD-kit training data. Supports 50+ formats including deepmd, xyz or extxyz, ABACUS, VASP, LAMMPS, CP2K, etc.
compatibility
Requires uvx (uv) for running dpdata
metadata.author
njzjz-bot
metadata.version
1.0
metadata.repository
https://github.com/deepmodeling/dpdata

dpdata CLI

dpdata is a tool for manipulating multiple atomic simulation data formats. This skill enables format conversion between various DFT/MD software outputs via command line.

Quick Start

Run dpdata via uvx:

bash
uvx dpdata <from_file> [options]

Command Line Usage

text
dpdata: Manipulating multiple atomic simulation data formats
usage: dpdata [-h] [--to_file TO_FILE] [--from_format FROM_FORMAT]
              [--to_format TO_FORMAT] [--no-labeled] [--multi]
              [--type-map TYPE_MAP [TYPE_MAP ...]] [--version]
              from_file
Arguments
ArgumentDescription
from_fileRead data from a file (positional)
--to_file, -ODump data to a file
--from_format, -iFormat of from_file (default: "auto")
--to_format, -oFormat of to_file
--no-labeled, -nLabels aren't provided (default: False)
--multi, -mSystem contains multiple directories (default: False)
--type-map, -tType map for atom types
--versionShow dpdata version and exit

Common Examples

Convert VASP OUTCAR to deepmd format
bash
uvx dpdata OUTCAR -i vasp/outcar -O deepmd_data -o deepmd/raw
Convert LAMMPS dump to VASP POSCAR
bash
uvx dpdata dump.lammps -i lammps/dump -O POSCAR -o vasp/poscar
Convert with type map
bash
uvx dpdata OUTCAR -i vasp/outcar -O deepmd_data -o deepmd/raw -t C H O N
Convert multiple systems
bash
uvx dpdata data_dir -i vasp/outcar -O output_dir -o deepmd/comp --multi
Convert to deepmd/npy (compressed format)
bash
uvx dpdata OUTCAR -i vasp/outcar -O deepmd_npy -o deepmd/npy
Convert to deepmd/hdf5
bash
uvx dpdata OUTCAR -i vasp/outcar -O data.h5 -o deepmd/hdf5

Supported Formats

Formats may be updated. For the complete and latest list, see:

DeePMD-kit Formats
Format NameDescription
deepmd/rawDeePMD-kit raw text format
deepmd/comp / deepmd/npyDeePMD-kit compressed numpy format
deepmd/npy/mixedDeePMD-kit mixed type format
deepmd/hdf5DeePMD-kit HDF5 format
VASP Formats
Format NameDescription
vasp/poscar / vasp/contcar / poscar / contcarVASP structure files
vasp/outcar / outcarVASP OUTCAR output
vasp/xml / xmlVASP XML output
vasp/stringVASP string format
LAMMPS Formats
Format NameDescription
lammps/lmp / lmpLAMMPS data file
lammps/dump / dumpLAMMPS dump file
ABACUS Formats
Format NameDescription
stru / abacus/struABACUS structure file
abacus/lcao/scf / abacus/pw/scf / abacus/scfABACUS SCF output
abacus/lcao/md / abacus/pw/md / abacus/mdABACUS MD output
abacus/lcao/relax / abacus/pw/relax / abacus/relaxABACUS relax output
Quantum ESPRESSO Formats
Format NameDescription
qe/cp/trajQE CP trajectory
qe/pw/scfQE PWscf output
CP2K Formats
Format NameDescription
cp2k/outputCP2K output
cp2k/aimd_outputCP2K AIMD output
Gaussian Formats
Format NameDescription
gaussian/logGaussian log file
gaussian/fchkGaussian formatted checkpoint
gaussian/mdGaussian MD output
gaussian/gjfGaussian input file
Other Formats
Format NameDescription
xyzXYZ format
mace/xyz / nequip/xyz / gpumd/xyz / extxyz / quip/gap/xyzExtended XYZ variants
ase/structureASE structure format
ase/trajASE trajectory
pymatgen/structurepymatgen structure
pymatgen/moleculepymatgen molecule
gromacs/gro / groGROMACS gro file
siesta/outputSIESTA output
siesta/aimd_outputSIESTA AIMD output
pwmat/output / pwmat/mlmd / pwmat/movementPWmat output
pwmat/final.config / pwmat/atom.configPWmat config
orca/spoutORCA output
psi4/outPSI4 output
dftbplusDFTB+ output
fhi_aims/output / fhi_aims/mdFHI-aims output
amber/mdAMBER MD
n2p2n2p2 format
mol_file / molMOL file
sdf_file / sdfSDF file
openmx/mdOpenMX MD
sqm/outSQM output
sqm/inSQM input
listList format
3dmol3Dmol visualization
Show full SKILL.md (234 more words)Show less
Extended XYZ (extxyz) Format Details

The following format names are all equivalent and invoke the same reader/writer:

  • extxyz — general-purpose extended XYZ
  • quip/gap/xyz / quip/gap/xyz_file — QUIP/GAP framework datasets
  • mace/xyz — MACE model training data
  • nequip/xyz — NequIP model training data
  • gpumd/xyz — GPUMD simulation data

Important: Plain xyz is a different, simpler format that stores atom species and coordinates but does not provide per-frame properties such as energies, forces, cell information, or periodic boundary conditions. Do not confuse xyz with extxyz.

CLI Examples for extxyz
bash
# Multi-frame extxyz trajectory → deepmd/npy (--multi preserves all frames)
uvx dpdata data.xyz -i extxyz -O deepmd_data -o deepmd/npy --multi

# Heterogeneous extxyz (mixed compositions) → deepmd/npy/mixed
uvx dpdata data.xyz -i extxyz -O deepmd_data -o deepmd/npy/mixed --multi

# Convert extxyz to VASP POSCAR (single-frame input only)
uvx dpdata data.xyz -i extxyz -O POSCAR -o vasp/poscar

# Convert a single-frame extxyz with explicit type map
uvx dpdata data.xyz -i extxyz -O deepmd_data -o deepmd/npy -t H C N O
Tips for extxyz
  1. Use -i extxyz explicitly when working with .xyz files that contain extended XYZ data. Using -i xyz retains only atom species and coordinates, omitting per-frame properties such as energies, forces, and cell information.
  2. Use --multi for any multi-frame extxyz file. Without --multi, the CLI constructs a LabeledSystem that keeps only the first frame. This applies to all multi-frame trajectories, not just heterogeneous (mixed-composition) files. dpdata groups frames by chemical formula internally.
  3. All alias names behave identically — -i mace/xyz, -i nequip/xyz, -i gpumd/xyz, -i quip/gap/xyz, -i quip/gap/xyz_file, and -i extxyz produce the same result.

Tips

  1. Auto-detection: Use -i auto (default) to let dpdata detect format automatically
  2. Type mapping: Use -t to specify atom type order for deepmd formats
  3. Multi-system: Use --multi for directories containing multiple systems
  4. Compressed output: Use deepmd/npy or deepmd/hdf5 for smaller file sizes

References

© jinzhezenggroup, LGPL-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

SKILL.md and 1 other file in tools/dpdata-cli of jinzhezenggroup/computational-chemistry-agent-skills.

  • SKILL.md
  • README.md

Open the folder on GitHubat commit 5c19e75

Compare with similar skills

Dpdata CLI 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.

Dpdata CLI compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Dpdata CLI this skilljinzhezenggroup/computational-chemistry-agent-skills148—~2.6kAutomated safety check: PassLGPL-3.0
Convertremotion-dev/remotion63k—~247Automated safety check: PassCustom licence
File Format Converterjeremylongshore/tons-of-skills-marketplace2.8k—~569Automated safety check: PassMIT
Tao Convert Dataset FormatNVIDIA/skills3.5k—~1.3kAutomated safety check: NotesApache-2.0
Latex Manuscript Format Converteraipoch/medical-research-skills2k—~2.9kAutomated safety check: PassMIT
Format ConverterAFK-surf/OpenBridge430—~549Automated safety check: PassMIT

Similar skills

  • Convert

    remotion-dev/remotion

    Official

    Start the local @remotion/convert app and open it in the Codex browser.

    63k GitHub stars~247 tokensUpdated today
    Media & CreativeAuto-check passed
  • File Format Converter

    jeremylongshore/tons-of-skills-marketplace

    Convert file format converter operations. An agent skill from jeremylongshore/tons-of-skills-marketplace.

    2.8k GitHub stars~569 tokensUpdated today
    Data & AnalyticsAuto-check passed
  • Official

    Run tao-daft convert to convert NVIDIA TAO DAFT datasets between supported formats.

    3.5k GitHub stars~1.3k tokensUpdated today
    Auto-check: notes
  • Latex Manuscript Format Converter

    aipoch/medical-research-skills

    Converts existing manuscript content into LaTeX format aligned with a target journal, conference, or template while preserving manuscript meaning and structural integrity.

    2k GitHub stars~2.9k tokensUpdated 22 days ago
    Documents & OfficeAuto-check passed
  • Format Converter

    AFK-surf/OpenBridge

    Convert files between formats. An agent skill from AFK-surf/OpenBridge.

    430 GitHub stars~549 tokensUpdated 4 mo ago
    Documents & OfficeAuto-check passed
  • Compose Atoms

    lobehub/lobehub

    Splits a heavy front-end domain into capability atoms that each host imports separately, sinking state into each atom instead of adding mode or readOnly flags.

    83k GitHub stars~2.6k tokensUpdated today
    Frontend & DesignAuto-check passed

More from jinzhezenggroup/computational-chemistry-agent-skills

All 62 skills in this repo
  • Quantum ESPRESSO DFT Task Builder

    jinzhezenggroup/computational-chemistry-agent-skills

    Turns a user-supplied atomic structure and DFT settings into a runnable Quantum ESPRESSO input file, stopping short of submitting the job.

    148 GitHub stars~1.8k tokensUpdated today
    Auto-check passed
  • DP-GEN Simplify Workflow

    jinzhezenggroup/computational-chemistry-agent-skills

    Prepares, validates and runs DP-GEN simplify jobs that thin out repeated or redundant DeepMD datasets, generating param.json and machine.json for local or scheduler runs.

    148 GitHub stars~2.7k tokensUpdated today
    Auto-check passed
  • LAMMPS with DeePMD-kit

    jinzhezenggroup/computational-chemistry-agent-skills

    Prepares and runs molecular dynamics simulations in LAMMPS with a DeePMD machine-learning potential, writing the input script and choosing NVE, NVT or NPT.

    148 GitHub stars~2.8k tokensUpdated today
    Auto-check passed
  • LAMMPS ReaxFF Setup

    jinzhezenggroup/computational-chemistry-agent-skills

    Prepares and explains LAMMPS input scripts for reactive molecular dynamics with the ReaxFF potential, including charge equilibration and ensemble choice.

    148 GitHub stars~1.8k tokensUpdated today
    Auto-check passed
  • RDKit Conformer Generator

    jinzhezenggroup/computational-chemistry-agent-skills

    Generates 3D molecular conformers from SMILES strings or files with RDKit, keeps the lowest-energy one per molecule, and falls back to 2D coordinates when embedding fails.

    148 GitHub stars~2.4k tokensUpdated today
    Auto-check passed
  • RDKit Descriptors and Fingerprints

    jinzhezenggroup/computational-chemistry-agent-skills

    Computes RDKit physicochemical descriptors and molecular fingerprints from SMILES through a uv-run CLI script that skips and logs invalid molecules.

    148 GitHub stars~2.3k tokensUpdated today
    Auto-check passed

Questions about Dpdata CLI

What does Dpdata CLI do?

Convert and manipulate atomic simulation data formats using dpdata CLI. Dpdata CLI is an agent skill from jinzhezenggroup/computational-chemistry-agent-skills. Convert and manipulate atomic simulation data formats using dpdata CLI.

When should I use Dpdata CLI?

Dpdata CLI fits situations like: converting between DFT/MD output formats; preparing DeePMD-kit training data.

How do I install Dpdata CLI in Claude Code?

Run `npx skills add jinzhezenggroup/computational-chemistry-agent-skills --skill dpdata-cli -a claude-code`. Or copy the skill folder (tools/dpdata-cli in jinzhezenggroup/computational-chemistry-agent-skills) into .claude/skills/dpdata-cli in your project. Claude Code loads it when a task matches its description.

How do I install Dpdata CLI in Codex?

Run `npx skills add jinzhezenggroup/computational-chemistry-agent-skills --skill dpdata-cli -a codex`. Or copy the skill folder (tools/dpdata-cli in jinzhezenggroup/computational-chemistry-agent-skills) into .agents/skills/dpdata-cli in your project. Codex loads it when a task matches its description.

Can I use Dpdata CLI 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 jinzhezenggroup/computational-chemistry-agent-skills --skill dpdata-cli -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/dpdata-cli, .gemini/skills/dpdata-cli, .github/skills/dpdata-cli and .opencode/skills/dpdata-cli in your project.

What does Dpdata CLI need to run?

Going by SKILL.md and its folder, Dpdata CLI needs the command-line tools its instructions call (uvx). Compatibility (from SKILL.md): Requires uvx (uv) for running dpdata.

Does Dpdata CLI access the network?

SKILL.md names 2 domains. As links in the text: docs.deepmodeling.com and github.com. This is read from the text; nothing was executed.

Is Dpdata CLI 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 Dpdata CLI use?

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

How many tokens does Dpdata CLI use?

About 2.6k tokens (SKILL.md is roughly 10k 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 Dpdata CLI?

Skills that share tags, products or a category with Dpdata CLI: Convert (remotion-dev/remotion, 63k stars), File Format Converter (jeremylongshore/tons-of-skills-marketplace, 2.8k stars), Tao Convert Dataset Format (NVIDIA/skills, 3.5k stars) and Latex Manuscript Format Converter (aipoch/medical-research-skills, 2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Dpdata CLI?

jinzhezenggroup (a GitHub organization) maintains it in jinzhezenggroup/computational-chemistry-agent-skills, which has 148 GitHub stars. The repository holds 62 skills in this directory. The repository was last updated on October 9, 2026.

Source: jinzhezenggroup/computational-chemistry-agent-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.