Agent skill

Packmol

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

Generate initial configurations for molecular simulations using Packmol.

AGPL-3.0Auto-check passedResearch & Science

Install Packmol

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

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

GitHub CLI
$ gh skill install Hello-QM/catgo-LRG packmol --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/packmol .claude/skills/packmol && 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
packmol
GitHub stars
205
Token cost
~1.1k tokens
SKILL.md length
346 words
Files
1
Skills in repo
75
Repo updated
First seen
Licence
AGPL-3.0

At a glance

Generate initial configurations for molecular simulations using Packmol.

  • Works in 2 steps: Prepare molecule files → Create Packmol input and run
  • Tasks that involve Drug discovery and cheminformatics
  • SKILL.md covers When to Use, Prerequisites, Workflow Steps and Packmol Input Template —…, plus 6 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Packmol is an agent skill from Hello-QM/catgo-LRG. Generate initial configurations for molecular simulations using Packmol. Build liquid boxes, mixtures, solutions, and solvated systems by packing molecules into a defined region.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts. Compatibility notes: Requires Packmol installed (apt install packmol or compiled from source). Input molecules must be in PDB or XYZ format.

It sits in Research & Science, covering Drug discovery and cheminformatics. 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.

When your agent uses it

  • Tasks that involve Drug discovery and cheminformatics

Example prompts

  • “/packmol”

Requirements

  • Compatibility (from SKILL.md): Requires Packmol installed (apt install packmol or compiled from source). Input molecules must be in PDB or XYZ format.

Workflow steps

2 steps, taken from the step headings in SKILL.md.

  1. Prepare molecule files
  2. Create Packmol input and run

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 bash).

    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.

  • Compatibility

    Requires Packmol installed (apt install packmol or compiled from source). Input molecules must be in PDB or XYZ format.

    From compatibility in the SKILL.md frontmatter.

Context cost

Packmol loads about 1.1k tokens when it runs. Until then it costs about 47 tokens; SKILL.md has 346 words of instructions outside code blocks.

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

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). 346 words, ~1,102 tokens.

Download SKILL.mdSave it as .claude/skills/packmol/SKILL.md (or your agent's skills folder).
name
packmol
description
Generate initial configurations for molecular simulations using Packmol. Build liquid boxes, mixtures, solutions, and solvated systems by packing molecules into a defined region.
compatibility
Requires Packmol installed (apt install packmol or compiled from source). Input molecules must be in PDB or XYZ format.
catalog-hidden
true

Packmol — Mixture/Solution Box Generation

When to Use

  • User needs to build a liquid simulation box (water, organic solvents)
  • User wants to create a mixture of different molecules
  • User needs to solvate a solute in a solvent box
  • User is preparing initial structures for LAMMPS ReaxFF or classical MD
  • User needs to fill a region with molecules at a target density

Prerequisites

  1. Packmol installed (packmol < /dev/null should print version)
  2. Molecule coordinate files in PDB or XYZ format
  3. For molecules from SMILES: first convert with Open Babel (data/openbabel/SKILL.md)

Workflow Steps

1. Prepare molecule files

If starting from SMILES, convert to PDB first:

bash
obabel -:"O" -O water.pdb --gen3d -h
obabel -:"CCO" -O ethanol.pdb --gen3d -h
2. Create Packmol input and run
catgo_workflow_engine(action="add_task", params={
  "workflow_id": "wf_xxx",
  "task_type": "shell",
  "name": "packmol_mix",
  "command": "packmol < mixture.inp > packmol.log 2>&1",
  "input_files": {
    "mixture.inp": "<packmol input>",
    "water.pdb": "<water coords>",
    "ethanol.pdb": "<ethanol coords>"
  },
  "system_name": "water_ethanol_mix"
})

Packmol Input Template — Simple Liquid Box

tolerance 2.0
filetype pdb
output mixture.pdb

structure water.pdb
  number 1000
  inside box 0.0 0.0 0.0 30.0 30.0 30.0
end structure

Packmol Input Template — Binary Mixture

tolerance 2.0
filetype pdb
output mixture.pdb

# Water (70% by count)
structure water.pdb
  number 700
  inside box 0.0 0.0 0.0 40.0 40.0 40.0
end structure

# Ethanol (30% by count)
structure ethanol.pdb
  number 300
  inside box 0.0 0.0 0.0 40.0 40.0 40.0
end structure

Packmol Input Template — Solvated Solute

tolerance 2.0
filetype pdb
output solvated.pdb

# Solute (fixed at center)
structure solute.pdb
  number 1
  center
  fixed 20.0 20.0 20.0 0.0 0.0 0.0
end structure

# Solvent around solute
structure water.pdb
  number 500
  inside box 0.0 0.0 0.0 40.0 40.0 40.0
  outside sphere 20.0 20.0 20.0 5.0
end structure

Packmol Input Template — Layered System (e.g., Interface)

tolerance 2.0
filetype pdb
output interface.pdb

# Liquid phase
structure hexane.pdb
  number 200
  inside box 0.0 0.0 0.0 30.0 30.0 15.0
end structure

# Gas phase
structure oxygen.pdb
  number 50
  inside box 0.0 0.0 15.0 30.0 30.0 30.0
end structure

Box Size Estimation

Target density determines box size. For water at 1 g/cm3:

N_molecules * M_molecule / (N_A * V_box) = density

For 1000 water molecules:
V = 1000 * 18.015 / (6.022e23 * 1.0) = 2.993e-20 cm3
L = V^(1/3) = 3.1e-7 cm = 31.0 Angstrom

Use a box slightly larger (e.g., 32 Ang) and equilibrate with NPT MD.

Parameter Guidance

ParameterTypical valueNotes
tolerance2.0 AngMinimum distance between atoms of different molecules
filetypepdb or xyzMust match input molecule files
numbervariesNumber of molecules of each type
inside boxx0 y0 z0 x1 y1 z1Rectangular region (Angstrom)
inside spherecx cy cz rSpherical region
outside spherecx cy cz rExclusion zone (for solvation)
fixedx y z a b cFix position and orientation (angles in degrees)

Common Pitfalls

  1. Tolerance too small — tolerance 2.0 works for most cases. Smaller values cause Packmol to fail to converge.
  2. Box too small — if density is too high, Packmol cannot place all molecules. Increase box size.
  3. Wrong filetype — filetype pdb must match the actual input file format.
  4. No equilibration after Packmol — Packmol output is NOT equilibrated. Always run NPT MD to relax the density.
  5. Missing hydrogens — ensure input molecules have correct hydrogens before packing.
  6. Molecule overlap with solute — use outside sphere to prevent solvent from overlapping with a fixed solute.
  7. Convergence failure — if Packmol does not converge, increase tolerance or box size, or reduce molecule count.

© 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/packmol of Hello-QM/catgo-LRG.

Open the folder on GitHubat commit fd6291b

Compare with similar skills

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

Packmol compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Packmol this skillHello-QM/catgo-LRG205—~1.1kAutomated safety check: PassAGPL-3.0
MolecodeAtomFlow-AI/MoleCode305—~1.9kAutomated safety check: PassMIT
Drug DiscoveryTommy-yw/RunbookHermes5461 repos~2.3kAutomated safety check: PassMIT
DiffDock Molecular DockingK-Dense-AI/scientific-agent-skills48k1 repos~3kAutomated safety check: NotesMIT
Biomedical Analysis Dispatchxjtulyc/MedgeClaw6171 repos~2kAutomated safety check: PassNone
Edu Chem Reactionwy51ai/edulab1.4k—~1.2kAutomated safety check: PassApache-2.0

Similar skills

  • Molecode

    AtomFlow-AI/MoleCode

    A skill your agent uses for deterministic molecule understanding, graph-level editing, generation, and validation with MoleCode — an explicit Mermaid graph in which every atom and bond is a typed…

    305 GitHub stars~1.9k tokensUpdated 4 mo ago
    Research & ScienceAuto-check passed
  • Drug Discovery

    Tommy-yw/RunbookHermes

    Pharmaceutical research assistant for drug discovery workflows.

    546 GitHub starsUsed in 1 repo~2.3k tokens
    Research & ScienceAuto-check passed
  • DiffDock Molecular Docking

    K-Dense-AI/scientific-agent-skills

    Predicts how small molecules bind to a protein with DiffDock, covering batch docking, pose ranking by confidence and checks on the results; not for binding affinity.

    48k GitHub starsUsed in 1 repo~3k tokens
    Research & ScienceAuto-check: notes
  • Routes bioinformatics, drug discovery, clinical and multi-omics tasks from a chat interface to Claude Code sessions running K-Dense scientific skills, with a live dashboard per task.

    617 GitHub starsUsed in 1 repo~2k tokens
    Research & ScienceAuto-check passed
  • Edu Chem Reaction

    wy51ai/edulab

    把一个化学反应做成自包含的微观 3D 交互演示网页:左/上为 Three.js 可交互分子动画 (拖滑块看断键·成键·原子重组,分步高亮),右为 KaTeX 反应方程 + 分步讲解 + 原子守恒计数 + 可选能量-反应进程曲线。支持三入口——给定文字反应/方程、随机出题、上传图片识别后演示。

    1.4k GitHub stars~1.2k tokensUpdated 9 days ago
    Research & ScienceAuto-check passed
  • Biopipelines

    locbp-uzh/biopipelines

    Design and run computational protein and ligand workflows on a GPU: binder and enzyme design, de novo backbone generation, inverse folding and sequence redesign, structure prediction, protein-ligand…

    109 GitHub stars~2.4k tokensUpdated 7 days ago
    Research & ScienceAuto-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 15 days ago
    Auto-check passed
  • Lammps Deepmd

    Hello-QM/catgo-LRG

    Run LAMMPS molecular dynamics with DeePMD-kit machine learning potentials.

    205 GitHub starsUsed in 1 repo~1k tokens
    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 15 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 15 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 15 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 15 days ago
    Auto-check passed

Questions about Packmol

What does Packmol do?

Generate initial configurations for molecular simulations using Packmol. Packmol is an agent skill from Hello-QM/catgo-LRG. Generate initial configurations for molecular simulations using Packmol.

When should I use Packmol?

Packmol fits situations like: tasks that involve Drug discovery and cheminformatics.

How do I install Packmol in Claude Code?

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

How do I install Packmol in Codex?

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

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

What does Packmol need to run?

SKILL.md names no scripts, command-line tools or credentials: Packmol is instructions for the agent only. Compatibility (from SKILL.md): Requires Packmol installed (apt install packmol or compiled from source). Input molecules must be in PDB or XYZ format. .

Does Packmol 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 Packmol 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 Packmol use?

Packmol 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 Packmol use?

About 1.1k tokens (SKILL.md is roughly 4.4k 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 Packmol?

Skills that share tags, products or a category with Packmol: Molecode (AtomFlow-AI/MoleCode, 305 stars), Drug Discovery (Tommy-yw/RunbookHermes, 546 stars), DiffDock Molecular Docking (K-Dense-AI/scientific-agent-skills, 48k stars) and Biomedical Analysis Dispatch (xjtulyc/MedgeClaw, 617 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Packmol?

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.