proteinmpnn

proteinmpnn is a skill for Claude Code, Codex from naity/FM4Life. It costs 92 tokens per session (1,859 once invoked), scanned A, original, MIT.

A protein-design skill that creates amino-acid sequences for a given protein backbone, the stable structural framework of a protein. This approach is called inverse folding because it starts with a desired shape and works backward to a sequence.

In plain words
What is it for?
Use it to design or score sequences for PDB structures, preserve selected residues, design multiple chains, enforce symmetry, and apply amino-acid or evolutionary preferences.
Why use it?
It helps find sequences likely to fold into a specified structure and avoids redesigning positions that must stay unchanged.

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 python helper_scripts/parse_multiple_chains.py \.

Good fit Use it to design or score sequences for PDB structures, preserve selected residues, design multiple chains, enforce symmetry, and apply amino-acid or evolutionary preferences.

Compare 6 skills from other repositories ↓
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/naity/FM4Life
agentmods
npx agentmods add skills/naity/fm4life/proteinmpnn

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 proteinmpnn

README.md
[![agentmods](https://agentmods.dev/badge/skills/naity/fm4life/proteinmpnn/github.svg)](https://agentmods.dev/skills/naity/fm4life/proteinmpnn)
Your own site
<a href="https://agentmods.dev/skills/naity/fm4life/proteinmpnn"><img src="https://agentmods.dev/badge/skills/naity/fm4life/proteinmpnn/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for proteinmpnn

Your own site · 80×15
<a href="https://agentmods.dev/skills/naity/fm4life/proteinmpnn"><img src="https://agentmods.dev/badge/skills/naity/fm4life/proteinmpnn.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 92 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,859 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.
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.00092 $0.01859
Opus 5 $0.00046 $0.00929
Sonnet 5 $0.00018 $0.00372
Haiku 4.5 $0.00009 $0.00186

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

Security

Grade A, and why

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

The scan reads SKILL.md. This mod also ships 1 executable file (scripts/design.py), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

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.

skills/proteinmpnn/SKILL.md · 218 lines

How it starts

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

ProteinMPNN: Inverse Folding for Protein Sequence Design

Overview

ProteinMPNN designs amino acid sequences for a given protein backbone structure. It is the sequence design step in the modern protein design pipeline:

RFdiffusion (backbone) → ProteinMPNN (sequence) → AlphaFold2 (validation)

Given a backbone PDB, ProteinMPNN outputs sequences that are predicted to fold into that structure. It can design multiple chains simultaneously, lock specific residues, enforce symmetry, and score existing sequences.

Core capabilities:

  • Sequence design — generate sequences for any protein backbone
  • Scoring — evaluate how well a given sequence fits a structure
  • Fixed positions — lock active site or interface residues
  • Tied positions — enforce symmetric sequences across chains (homooligomers)
  • Amino acid bias — favor or disfavor specific amino acids globally or per-residue
  • PSSM guidance — incorporate evolutionary information

Installation

# Create conda environment
conda create --name mlfold python=3.9
conda activate mlfold

# Install PyTorch with CUDA
conda install pytorch torchvision torchaudio cudatoolkit=11.3 -c pytorch

# Clone repository
git clone https://github.com/dauparas/ProteinMPNN.git
cd ProteinMPNN

No pip install — run directly from the repository.

Model Checkpoints

Checkpoint Use case
v_48_020.pt Default; best general-purpose model
v_48_030.pt Latest checkpoint
v_48_010.pt Intermediate checkpoint
v_48_002.pt Early checkpoint
soluble_model_weights/v_48_020.pt Soluble proteins only
ca_model_weights/v_48_020.pt CA-only backbone (faster)

Default: v_48_020.pt. Use --use_soluble_model or --ca_only to switch model families.

Core Workflows

1. Minimal monomer design

python protein_mpnn_run.py \
  --pdb_path input.pdb \
  --pdb_path_chains "A" \
  --num_seq_per_target 8 \
  --sampling_temp "0.1" \
  --out_folder results/

Read the full file on GitHub · 218 lines

Files

What ships with it

2 files 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 · 218 lines · 92 tokens per session scan A e35a5ee4cc61

Subscribe to this mod's changes

proteinmpnn is a skill published in the GitHub repository naity/FM4Life (2 stars, last pushed 5mo ago), licensed MIT. It adds 92 tokens to every session and 1,859 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-31.

Related

Other skills, from other repositories

drug-repurposing

Systematic drug repurposing via signature matching, target-based analysis, network proximity, genetic evidence scoring, and clinical evidence mining.

inflexa-ai/inflexa · 30 tokens

genomic-variants

Analysis of called genomic variants — filtering, annotation, GWAS, and population-genetics summaries from VCF and PLINK-format data.

inflexa-ai/inflexa · 31 tokens

omics-general

Cross-cutting principles for all omics analysis — AnnData/MuData universal containers, Python-first policy, data format detection, analysis phases, and shared analytical methods.

inflexa-ai/inflexa · 36 tokens

external-model-validation

Use when validating an existing prognostic risk signature on an external bulk expression cohort with survival outcomes, producing risk scores, Kaplan-Meier curves, risk distribution plots, heatmap, and time-dependent ROC curves. NOT for: model training, feature selection, nomogram construction, calibration analysis…

aipoch/medical-research-skills · 66 tokens

gsva-analysis-and-visualization

Use this skill to run GSVA or ssGSEA pathway-level differential analysis from a bulk expression matrix and a sample group file, then generate a heatmap from the saved GSVA result object. Trigger keywords: GSVA, ssGSEA, pathway enrichment, KEGG pathway analysis, MSigDB. NOT for: gene-level differential expression…

aipoch/medical-research-skills · 88 tokens

medical-research-literature-reader-pro

A medical-research-native literature reading skill for users with clinical, bioinformatics, translational, and basic experimental backgrounds. Use this skill whenever a user wants to read, analyze, critique, or interpret a medical or scientific paper — whether they provide a PDF, abstract, DOI, PMID, or just a title.…

aipoch/medical-research-skills · 199 tokens