ligandmpnn

ligandmpnn is a skill for Claude Code, Codex from aipoch/open-science. It costs 100 tokens per session (1,682 once invoked), scanned A, original, Apache-2.0.

A protein-design tool that proposes amino-acid sequences for a known protein structure while considering nearby molecules, nucleic acids, or metal atoms. Inverse folding means designing a sequence that could form a chosen three-dimensional structure.

In plain words
What is it for?
Use it to redesign residues around a bound small molecule, cofactor, nucleic acid, or metal, and to create candidate sequences and structure files for testing.
Why use it?
It accounts for substances in a binding site that simpler protein-design tools may ignore, helping designs fit the surrounding chemical environment.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

Needs its repository: it runs a file that does not travel with it, so clone the repository first. The line is --checkpoint_ligand_mpnn ./model_params/ligandmpnn_v_32_010_25.pt \.

Good fit Use it to redesign residues around a bound small molecule, cofactor, nucleic acid, or metal, and to create candidate sequences and structure files for testing.

Compare 6 skills from other repositories ↓
About the project

Open Science is a local-first, model-agnostic workbench for reproducible scientific research. Scientists use its AI agents, Python and R execution, data connectors, and traceable outputs for tasks such as literature review, analysis, simulation, and visualization across macOS, Windows, and Linux.

aipoch/open-science · 4,137 stars · on GitHub · aipoch.com

Install

Getting it into your agent

It runs from inside its repository, so the clone comes first — what it calls does not travel with the file alone.

Clone the repo
git clone --depth 1 https://github.com/aipoch/open-science
agentmods
npx agentmods add skills/aipoch/open-science/ligandmpnn

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for ligandmpnn

README.md
[![agentmods](https://agentmods.dev/badge/skills/aipoch/open-science/ligandmpnn.svg)](https://agentmods.dev/skills/aipoch/open-science/ligandmpnn)
Your own site
<a href="https://agentmods.dev/skills/aipoch/open-science/ligandmpnn"><img src="https://agentmods.dev/badge/skills/aipoch/open-science/ligandmpnn.svg" alt="Measured on agentmods" height="20"></a>
Per session 100 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,682 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector warn 7 Sept 2026
SkillSpector: 1 finding, up to medium

These are SkillSpector’s own severities. On a checked sample its high-severity flags on skills were ~96% false positives — a documented command, a public API, a “never do X” rule — so we show them as a caution to read, not a verdict. Why →

  • medium Prompt Injection · line 113
    Large whitespace padding was detected (a block of blank lines or a long run of spaces). This can push injected instructions below or to the right of the visible area so a human reviewer never sees them while the agent still reads them. Manual review of the hidden content is recommended.
    Fix: Remove the large whitespace padding (blank-line blocks or long space runs) and review any content hidden below or to the right of it. Keep skill files compact and reviewable so no instructions can be
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00100 $0.01682
Opus 5 $0.00050 $0.00841
Sonnet 5 $0.00020 $0.00336
Haiku 4.5 $0.00010 $0.00168

Measured 9d ago against content hash 57ec2d14fafd, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-08, from the pricing page.

Security

Grade A, and why

ligandmpnn scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 9d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

Origin

Copies of this mod

1 near-identical copy found in the catalogue:

resources/skills/ligandmpnn/SKILL.md · 124 lines

How it starts

The opening of the file, as written. The whole thing — 124 lines — stays where its author put it; the contents beside it link to each section on GitHub.

LigandMPNN

LigandMPNN extends the ProteinMPNN graph with non-protein atoms — small molecules, nucleic acids, and metals are visible to the network — so it is the right inverse-folding tool whenever the design surface includes a bound ligand or cofactor that vanilla proteinmpnn would ignore. The same run.py is also the most convenient runner for the other MPNN families because, unlike the original ProteinMPNN script, it threads designs back onto the input structure and writes PDBs alongside the FASTA. Code and weights are MIT (github.com/dauparas/LigandMPNN). The model is small enough to run on CPU — for a handful of designs on one structure that is seconds and usually faster than dispatching, so the normal path is local with pip install torch numpy biopython ProDy ml_collections dm-tree; a GPU helps for batched campaigns.

Running it

pip install torch numpy biopython ProDy ml_collections dm-tree
git clone --depth 1 https://github.com/dauparas/LigandMPNN.git ligandmpnn
cd ligandmpnn
sed -i 's/np\.int\b/np.int64/g' openfold/np/residue_constants.py   # repo pins numpy 1.23; alias removed in >=1.24
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.pdb \
  --out_folder out \
  --batch_size 8 --number_of_batches 4 \
  --temperature 0.1 \
  --fixed_residues "A45 A46 A47 A48"

Residue selections are space-separated {chain}{resnum} tokens inside one quoted string ("A45 A46 B10"; insertion codes append directly, "B82A"). That is the format for --fixed_residues and --redesigned_residues; --bias_AA_per_residue and --omit_AA_per_residue instead take a path to a JSON file whose keys use the same {chain}{resnum} form, and --chains_to_design is comma-separated ("A,B"). If you want to redesign only the pocket, naming the pocket residues in --redesigned_residues is usually shorter than fixing everything else.

Under --out_folder you get seqs/<stem>.fa (headers carry overall_confidence and ligand_confidence), backbones/<stem>_{1..N}.pdb with the designed sequence threaded onto the input coordinates, and — with --pack_side_chains 1 — full-atom packed models in packed/. The threaded PDBs are the reason to prefer this runner even for protein-only jobs.

Read the full file on GitHub · 124 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 9d ago First seen · 124 lines · 100 tokens per session scan A 57ec2d14fafd

Subscribe to this mod's changes

ligandmpnn is a skill published in the GitHub repository aipoch/open-science (4,137 stars, last pushed today), licensed Apache-2.0. It adds 100 tokens to every session and 1,682 once invoked, about $0.0005 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

build-paper-pipeline

Build the pipeline stages a manuscript's TODO comments ask for.

calkit/calkit · 0 tokens

check-questions

Review a Calkit project's questions and answers against their evidence. Use when the user invokes /calkit:check-questions, asks whether the project's answers are still true, or after a pipeline run changes results that answers cite.

calkit/calkit · 51 tokens

clinical-case-report

Structured medical case presentation for clinical rounds, conferences, and documentation. Generates SOAP-format or narrative case reports with physiologically accurate vitals, labs, and evidence-based plans. Use when the brief mentions "case report", "case presentation", "SOAP note", "clinical case", "ward rounds"…

nexu-io/open-design · 73 tokens

proof-checker

A mathematical proof review and repair workflow for LaTeX documents. It checks whether a proof has valid reasoning, addresses identified gaps, reviews the fixes, and produces an audit report.

wanshuiyin/Auto-claude-code-research-in-sleep · 87 tokens

paper-illustration

A workflow for generating academic illustrations, such as architecture diagrams and method visuals, with image generation and repeated review. Claude plans and checks the figure during the process.

wanshuiyin/Auto-claude-code-research-in-sleep · 67 tokens

paper-illustration-image2

Generate publication-quality academic illustrations through a local Codex app-server bridge that uses Codex native image generation. This is a separate experimental alternative to paper-illustration, intended for Claude Code users who want a GPT-image-style renderer without modifying the original skill.

wanshuiyin/Auto-claude-code-research-in-sleep · 59 tokens