chem-docking-void

Generate and rank 3D ligand conformers docked into porous CIF hosts.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires rdkit, pymatgen, VOID, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Finding plausible binding poses for small molecules inside porous host materials is slow and error-prone when done manually, especially when you need multiple sampled conformers and spatially diverse placements.

Core Features & Use Cases

  • Conformer generation and energy ranking: Generates 3D RDKit conformers, optimizes them with MMFF94, and selects the lowest-energy candidates.
  • Voronoi-based porous sampling: Places guests throughout a CIF host using VOID’s Voronoi clustering to cover accessible pore space.
  • Collision-aware pose acceptance: Applies physics-informed minimum-distance fitness functions to filter clashes between host and guest.
  • Practical outputs for downstream research: Exports ranked docked complexes as CIF files plus a docking_results.json summary for traceability and later DFT/MLIP steps.
  • Use Case: Prepare candidate zeolite/MOF-inclusion docking poses for follow-up energy evaluation, screening, or catalyst/adsorbate discovery.

Quick Start

Ask the agent to run chem-docking-void with your ligand SMILES and host CIF, requesting it to generate ranked docked CIF poses and a docking_results.json summary.

Frequently Asked Questions about chem-docking-void

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

FAQPage Schema
How do I dock small-molecule ligands into porous materials like zeolites or MOFs?

To dock ligands into porous materials, you need a valid SMILES string for the ligand and a CIF file for the host structure. The tool generates RDKit conformers, samples the host's pore space, and outputs ranked docked CIF poses.

How does Voronoi clustering place guest molecules in a CIF host structure?

Voronoi clustering identifies accessible pore space within a CIF host structure to sample physically plausible insertion sites. It places guest molecules throughout these voids, applying collision-aware distance checks to filter steric clashes between host and guest.

What do I need to generate 3D conformers and rank docking poses for adsorption screening?

You need a SMILES ligand, a CIF host, and an environment with RDKit, pymatgen, and VOID installed. The process generates 3D conformers optimizes them with MMFF94, and selects the lowest-energy candidates for ranking.

Can I use RDKit and pymatgen to prepare zeolite inclusion poses for DFT evaluation?

Yes, you can use RDKit and pymatgen to prepare zeolite inclusion poses for DFT evaluation. The workflow exports ranked docked complexes as CIF files and a docking_results.json summary containing pose metadata for downstream DFT or MLIP steps.

What is the best way to sample spatially diverse binding poses inside a MOF structure?

The best way to sample spatially diverse binding poses inside a MOF is using Voronoi-based porous sampling. This method covers the accessible pore space by placing multiple guest conformers and applying physics-informed minimum-distance fitness functions to accept valid poses.

Are there limitations when docking multiple conformers into porous host structures?

A key limitation is the requirement for specific dependencies like VOID, RDKit, and pymatgen in the execution environment. Additionally, the tool filters collisions using physics-informed minimum-distance fitness functions, which may reject poses if the host pores are too small.