protein-binder-design
Skill56 starsChanged 3 months agoMITView on GitHub
Design new proteins that bind a chosen surface, using BindCraft's AlphaFold2-guided hallucination or the RFdiffusion backbone plus ProteinMPNN sequence pipeline. Use this skill to specify a target epitope by hotspot residue, trim a receptor to the region worth designing against, set up a design campaign, and filter the output on the in-silico metrics that predict experimental success — interface predicted TM-score, predicted aligned error at the interface, buried surface area, and shape complementarity. Also trigger on BindCraft, RFdiffusion, ProteinMPNN, minibinder, hallucination, inverse folding, hotspot residue, epitope targeting, ipTM, or de novo binder.
1 other project uses a version of this.
Adopted by
Most recently taken up by
- patoangolano/bio-stacktheir own version, first seen Oct 15, 2026
Other versions1 project uses a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 1
- patoangolano/bio-stack★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository36 other files it gives its agents.
- adaptyvSkill
- admet-predictionSkill
- antibody-engineeringSkill
- autodock-vinaSkill
- binding-site-analysisSkill
- boltzSkill
- chemblSkill
- chemical-spaceSkill
- clinicaltrialsSkill
- datamolSkill
- deepchemSkill
- degradersSkill
- depmapSkill
- diffdockSkill
- esmSkill
- free-energy-perturbationSkill
- generative-designSkill
- glycoengineeringSkill
- immunogenicitySkill
- medchemSkill
- molecular-dynamicsSkill
- molfeatSkill
- ncats-araxSkill
- oligonucleotidesSkill
- openfdaSkill
- open-targetsSkill
- patent-landscapeSkill
- pkpd-translationSkill
- primekgSkill
- pytdcSkill
- rdkitSkill
- retrosynthesisSkill
- rowanSkill
- tamarindSkill
- target-safetySkill
- uniprot-rcsbSkill
The file
We split this skill into the rules it gives an agent
1 rule. About 0 are common, 1 is distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈1
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 29
Read references/epitope-selection.md before anything else, references/bindcraft-and-rfdiffusion.md to choose a pipeline, and
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
De Novo Protein Binder Design
Designing a new protein that binds a chosen surface used to be a research project. BindCraft reports 10–100% experimental success without high-throughput screening, and the pipeline is open source. The hard part is no longer the algorithm — it is choosing where to bind, and knowing that the metrics which select designs cannot tell you which one works.
Tools: BindCraft 1.5+ (Nature 2025, MIT), or RFdiffusion + ProteinMPNN + AlphaFold2. Both need AlphaFold2 weights and an NVIDIA GPU; a single trajectory is roughly half an hour. The bundled scripts prepare targets and filter output, and run anywhere.
Read references/epitope-selection.md before anything else, references/bindcraft-and-rfdiffusion.md to choose a pipeline, and references/filtering-and-validation.md before ordering — that one is judgement, not syntax.
The three scripts
| Script | Answers |
binder_target_spec.py | Where should the binder bind, and is that site usable? |
design_manifest.py | Which pipeline, how many trajectories, what will it cost? |
binder_filter.py | Which designs survive, and which should I actually order? |
The epitope decides the campaign
Everything downstream is compute spent on this one choice, and a bad site produces designs that fold beautifully and bind nothing — with no signal that the site was the problem.
python skills/protein-binder-design/scripts/binder_target_spec.py hotspots \
--pdb target.pdb --chain A --hotspots 45,47,52,89# 4 hotspot residues, maximum separation 14.2 A
resseq resname neighbours exposure issue
45 TYR 16 surface
47 LEU 24 buried buried -- cannot be contactedThree checks it applies: hotspots must be surface-exposed (a buried residue cannot be contacted, and neither design tool will say so), there should be 3–6 of them, and they must sit within ~25 Å — a wider spread is asking a single binder to do something impossible.
Then trim: designing against a 900-residue protein spends nearly all the compute on regions the
binder never touches. trim selects 100–200 residues around the epitope and warns outside that
band. Remove glycans and disorder first — neither is modelled, and both bias the interface toward
surface that is occluded in the real protein.
ipTM is not pTM
The most consequential confusion in reading design output. pTM scores the whole complex and is dominated by a large well-folded target; ipTM scores the interface. A design can have excellent pTM and no interface at all.
python skills/protein-binder-design/scripts/binder_filter.py filter --csv metrics.csv --alldesign iptm ipae plddt dsasa shape_complementarity unsat_hbonds passes failures
d1 0.88 7.2 88 1450 0.62 2 true
d2 0.61 14 72 800 0.48 7 false iptm<0.8|ipae>10|plddt<80|...| Metric | Threshold |
| ipTM | ≥ 0.80 |
| i_pAE | ≤ 10 Å |
| binder pLDDT | ≥ 80 |
| ΔSASA | ≥ 1000 Ų |
| shape complementarity | ≥ 0.55 |
| unsatisfied buried H-bonds | ≤ 4 |
These are a conjunction. Published success rates come from designs passing all of them together; sorting by ΔSASA alone gets you large, loosely packed interfaces.
The metrics cannot pick the winner
They come from the same model family that generated the designs — AlphaFold2 hallucination optimises until AlphaFold2 is confident, then AlphaFold2 confidence judges the result. That circularity is not fatal (the correlation with experimental success is the empirical finding the field rests on) but it means the metrics are self-consistency measures, not affinity predictions, and among survivors they cannot rank.
So the plate is the experiment:
python skills/protein-binder-design/scripts/binder_filter.py diverse --csv metrics.csv --n 24Ranking by ipTM alone returns near-identical designs — a top-24 list can be one solution tested 24
times. diverse enforces a pairwise identity ceiling. Order at least 20.
Cost is trajectories per ordered design
python skills/protein-binder-design/scripts/design_manifest.py plan --want 24 --pass-rate 0.03 --gpus 4# 801 trajectories to expect 24 filter survivors at a 3% pass rate
# 400.5 GPU-hours -> 4.17 days on 4 GPU(s)The filter pass rate is the hidden cost, and it is target-dependent. Set the trajectory count from it, not from the number of binders you want.
BindCraft or RFdiffusion
BindCraft co-folds binder and target at every iteration, so target flexibility is accounted for and no known binding site is needed. RFdiffusion generates against a fixed target, so induced fit is invisible to it — but it gives explicit control of binder length, fold, and secondary structure. On a flexible epitope, prefer BindCraft.
Four things to expect
- Most designs fail, and that is normal. A 10% success rate means nine of ten do not bind.
- Affinity confirms binding, not the model. A binder can bind well through an interface entirely different from the designed one. Only a structure tells you.
- Specificity is not predictable. Designs frequently bind close paralogues; counter-screen early, before optimisation.
- Nothing passing the filters usually means the epitope, not the trajectory count. More compute against a bad site produces more confident failures.
Composing with the rest of the bundle
uniprot-rcsb→ before: an experimental structure beats an AlphaFold model, which biases toward closed apo states with unreliable surface side chains.binding-site-analysis→ before: the hydrophobic-patch logic transfers, though protein-protein interfaces are flatter than small-molecule pockets and score lower.esm→ alongside: sequence-level sanity checks on the designs.immunogenicity→ after, not optional: a de novo binder is entirely non-germline.glycoengineering→ after: check the designs for introduced N-glycosylation sequons.adaptyv→ after: BLI/SPR on the plate you designed.tamarind→ instead: runs both pipelines in the cloud when there is no local GPU.
Reporting results honestly
Give every filter and threshold and say they were applied as a conjunction. Report trajectories run and survivors — the pass rate is the informative number. State that the metrics come from the same model family that produced the designs. Report ordered, expressed, and bound as three separate counts, because that chain is what the campaign actually delivered. Never quote ipTM as a predicted affinity.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

