alterlab-ligandmpnn
Design protein sequences around bound ligands, metals, and nucleic acids with LigandMPNN (Dauparas 2023) — inverse folding that conditions on non-protein context, so binding-pocket and metal-site residues are chosen to fit the actual ligand. Use when designing a small-molecule or
Install
npx skills add https://github.com/AlterLab-IEU/AlterLab-Academic-Skills/tree/main/skills/bioinformatics/alterlab-ligandmpnn
claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install alterlab-ieu-alterlab-academic-skills@llmmart
git clone https://github.com/AlterLab-IEU/AlterLab-Academic-Skills.git
The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole alterlab-ieu/alterlab-academic-skills collection as a plugin from our marketplace. Git is the plain clone.
Skill manifest
LigandMPNN (ligand-aware sequence design)
Overview
LigandMPNN (Dauparas et al. 2023; dauparas/LigandMPNN) extends ProteinMPNN's inverse
folding to condition on non-protein context — small-molecule ligands, metal ions, and
nucleic acids. Because the model sees the ligand/metal atoms, the residues it designs for a
binding pocket or metal site are chosen to complement what is actually bound, which
plain ProteinMPNN (protein-atoms-only) cannot do.
Use it whenever the design target is a site that contacts a ligand or ion. For sequence
design of a backbone with no bound context, use alterlab-proteinmpnn.
When to Use This Skill
Use this skill when the user wants to:
- Design a small-molecule binding pocket so the residues fit the ligand.
- Design a metal-coordinating site (e.g. Zn/Fe) with the ion in context.
- Redesign residues that contact a ligand, ion, or nucleic acid.
- Do enzyme active-site design where the substrate/cofactor should guide the choice.
Does NOT Trigger
| Scenario | Use instead |
|---|---|
| Sequence design for a backbone with no ligand/metal context | alterlab-proteinmpnn |
| Generate a backbone or scaffold a functional motif | alterlab-rfdiffusion |
| Validate a design by refolding | alterlab-alphafold |
| Co-fold the protein WITH the ligand from scratch | alterlab-boltz |
| Dock a ligand into a fixed pocket (pose, not sequence) | alterlab-diffdock |
Hand-off rule. When the request matches a row above, open your answer by naming that skill by its exact id (for example alterlab-proteinmpnn) and saying in one line why it fits better, then stop applying this skill's procedure. Name it even when you also need to ask for missing input. If only part of the request is out of scope, name the skill for that part and do only the in-scope part. A brief general pointer is fine; the named skill does the work.
Core Capabilities
1. Ligand-aware pocket design
# dauparas/LigandMPNN — clone, fetch weights once, then run run.py
git clone https://github.com/dauparas/LigandMPNN && cd LigandMPNN
bash get_model_params.sh "./model_params"
python run.py \
--model_type ligand_mpnn \
--checkpoint_ligand_mpnn "./model_params/ligandmpnn_v_32_010_25.pt" \
--pdb_path complex_with_ligand.pdb \
--out_folder out/ \
--seed 111 \
--batch_size 8 --number_of_batches 4
The input PDB must contain the ligand/metal atoms (HETATM). LigandMPNN designs pocket residues
that fit that context; use --redesigned_residues/--fixed_residues to target only the site.
Output FASTA headers carry overall_confidence and ligand_confidence (0–1, higher = more
confident), averaged over the redesigned residues only.
2. Metal-site and nucleic-acid context
Provide the coordinating ion or the nucleic-acid chain in the structure so the model conditions on it — critical for metalloenzyme and DNA/RNA-binding designs.
3. Site-focused redesign
Restrict design to the residues within a shell of the ligand (redesign the pocket, keep the
scaffold). Residues are named directly by chain+index — --redesigned_residues "A23 A24 B42D"
or the complement, --fixed_residues "C1 C2 …". Insertion codes are preserved (B42D), because
LigandMPNN parses structures with ProDy and keeps the original numbering rather than
renumbering. Add --ligand_mpnn_use_side_chain_context 1 to condition on the side-chain atoms
of the fixed residues as well as the backbone.
4. In the design pipeline
LigandMPNN provides the sequence step when the functional site involves a ligand: scaffold
or generate the site with alterlab-rfdiffusion, design the pocket sequence here, then validate
by refolding (alterlab-alphafold) and — if you need a pose/affinity — co-fold with
alterlab-boltz or dock with alterlab-diffdock.
Resources
references/ligandmpnn_usage.md— install/pinning, model types, HETATM/context input, site-restricted design, and pipeline integration. Loaded on demand.
Part of the AlterLab Academic Skills suite.
Files (alterlab-academic-skills)
-
evals
-
evals.json 3.5 KB
Loading…
-
-
references
-
ligandmpnn_usage.md 3.2 KB
Loading…
-
-
SKILL.md 5.3 KB
--- name: alterlab-ligandmpnn description: Design protein sequences around bound ligands, metals, and nucleic acids with LigandMPNN (Dauparas 2023) — inverse folding that conditions on non-protein context, so binding-pocket and metal-site residues are chosen to fit the actual ligand. Use when designing a small-molecule or metal binding pocket, redesigning residues that contact a ligand/ion/nucleic acid, or doing enzyme active-site design where the substrate matters. For backbone sequence design with NO ligand/metal context prefer alterlab-proteinmpnn; to GENERATE a backbone or scaffold a functional site prefer alterlab-rfdiffusion; to validate a design by refolding prefer alterlab-alphafold; to co-fold or dock the ligand prefer alterlab-boltz or alterlab-diffdock. Part of the AlterLab Academic Skills suite. license: MIT allowed-tools: Read Write Edit Bash(python:*) Bash(uv:*) compatibility: "Runs LigandMPNN (`dauparas/LigandMPNN`, PyTorch) under `uv run python` via its `run.py`. Model checkpoints download once (small; no account). CPU works for typical sizes; a GPU only speeds large batches. Input is a structure containing the protein PLUS the ligand/metal/nucleic-acid atoms (e.g. a PDB with the HETATM records)." metadata: skill-author: AlterLab version: "1.1.0" last_updated: "2026-09-23" --- # LigandMPNN (ligand-aware sequence design) ## Overview **LigandMPNN** (Dauparas et al. 2023; `dauparas/LigandMPNN`) extends ProteinMPNN's inverse folding to **condition on non-protein context** — small-molecule ligands, metal ions, and nucleic acids. Because the model *sees* the ligand/metal atoms, the residues it designs for a **binding pocket** or **metal site** are chosen to complement what is actually bound, which plain ProteinMPNN (protein-atoms-only) cannot do. Use it whenever the design target is a **site that contacts a ligand or ion**. For sequence design of a backbone with no bound context, use `alterlab-proteinmpnn`. ## When to Use This Skill Use this skill when the user wants to: - Design a **small-molecule binding pocket** so the residues fit the ligand. - Design a **metal-coordinating site** (e.g. Zn/Fe) with the ion in context. - Redesign residues that **contact a ligand, ion, or nucleic acid**. - Do **enzyme active-site** design where the substrate/cofactor should guide the choice. ### Does NOT Trigger | Scenario | Use instead | |----------|-------------| | Sequence design for a backbone with **no** ligand/metal context | `alterlab-proteinmpnn` | | **Generate** a backbone or scaffold a functional motif | `alterlab-rfdiffusion` | | Validate a design by refolding | `alterlab-alphafold` | | Co-fold the protein WITH the ligand from scratch | `alterlab-boltz` | | Dock a ligand into a fixed pocket (pose, not sequence) | `alterlab-diffdock` | **Hand-off rule.** When the request matches a row above, open your answer by naming that skill by its exact id (for example `alterlab-proteinmpnn`) and saying in one line why it fits better, then stop applying this skill's procedure. Name it even when you also need to ask for missing input. If only part of the request is out of scope, name the skill for that part and do only the in-scope part. A brief general pointer is fine; the named skill does the work. ## Core Capabilities ### 1. Ligand-aware pocket design ```bash # dauparas/LigandMPNN — clone, fetch weights once, then run run.py git clone https://github.com/dauparas/LigandMPNN && cd LigandMPNN bash get_model_params.sh "./model_params" python run.py \ --model_type ligand_mpnn \ --checkpoint_ligand_mpnn "./model_params/ligandmpnn_v_32_010_25.pt" \ --pdb_path complex_with_ligand.pdb \ --out_folder out/ \ --seed 111 \ --batch_size 8 --number_of_batches 4 ``` The input PDB must contain the ligand/metal atoms (HETATM). LigandMPNN designs pocket residues that fit that context; use `--redesigned_residues`/`--fixed_residues` to target only the site. Output FASTA headers carry `overall_confidence` and `ligand_confidence` (0–1, higher = more confident), averaged over the redesigned residues only. ### 2. Metal-site and nucleic-acid context Provide the coordinating ion or the nucleic-acid chain in the structure so the model conditions on it — critical for metalloenzyme and DNA/RNA-binding designs. ### 3. Site-focused redesign Restrict design to the residues within a shell of the ligand (redesign the pocket, keep the scaffold). Residues are named directly by chain+index — `--redesigned_residues "A23 A24 B42D"` or the complement, `--fixed_residues "C1 C2 …"`. Insertion codes are preserved (`B42D`), because LigandMPNN parses structures with ProDy and keeps the original numbering rather than renumbering. Add `--ligand_mpnn_use_side_chain_context 1` to condition on the side-chain atoms of the fixed residues as well as the backbone. ### 4. In the design pipeline LigandMPNN provides the **sequence** step when the functional site involves a ligand: scaffold or generate the site with `alterlab-rfdiffusion`, design the pocket sequence here, then validate by refolding (`alterlab-alphafold`) and — if you need a pose/affinity — co-fold with `alterlab-boltz` or dock with `alterlab-diffdock`. ## Resources - `references/ligandmpnn_usage.md` — install/pinning, model types, HETATM/context input, site-restricted design, and pipeline integration. Loaded on demand. Part of the AlterLab Academic Skills suite.
Comments (0)
Sign in to join the conversation.
Reviews (0)
No reviews yet.
No comments yet.