Protein design workflow
Skill adaptyvbio/protein-design-skills/skills/protein-design-workflow
End-to-end guidance for protein design pipelines. Use this skill when: (1) Starting a new protein design project, (2) Need step-by-step workflow guidance, (3) Understanding the full design pipeline, (4) Planning compute resources and timelines, (5) Integrating multiple design tools. For tool selection, use binder-design. For QC thresholds, use protein-qc.From its SKILL.md
npx -y skills add adaptyvbio/protein-design-skills --skill protein-design-workflowAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- runs commandsInstructs the agent to run 5 commands, including `curl -o target.pdb "https://files.rcsb.org/download/XXXX.pdb"` and 4 more.
- fetches URLsInstructs the agent to fetch 1 URL, including https://files.rcsb.org/download/XXXX.pdb.
What its file declares
Copied from the file, not written here
The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.
SKILL.md
4.9 KB, ~1.2k tokens by cl100k_base, as published. Nobody here has run it
Protein Design Workflow Guide
Standard binder design pipeline
Overview
Target Preparation --> Backbone Generation --> Sequence Design
| | |
v v v
(pdb skill) (rfdiffusion) (proteinmpnn)
| |
v v
Structure Validation --> Filtering
| |
v v
(alphafold/chai) (protein-qc)
Phase 1: Target preparation
1.1 Obtain target structure
# Download from PDB
curl -o target.pdb "https://files.rcsb.org/download/XXXX.pdb"
1.2 Clean and prepare
# Extract target chain
# Remove waters, ligands if needed
# Trim to binding region + 10A buffer
1.3 Select hotspots
- Choose 3-6 exposed residues
- Prefer charged/aromatic (K, R, E, D, W, Y, F)
- Check surface accessibility
- Verify residue numbering
Output: target_prepared.pdb, hotspot list
Phase 2: Backbone generation
Option A: RFdiffusion (diverse exploration)
# RFdiffusion runs from the official repo, not biomodals
python run_inference.py \
inference.input_pdb=target_prepared.pdb \
contigmap.contigs=[A1-150/0 70-100] \
ppi.hotspot_res=[A45,A67,A89] \
inference.num_designs=500
Option B: BindCraft (end-to-end)
modal run modal_bindcraft.py \
--input-pdb target_prepared.pdb \
--target-hotspot-residues "45,67,89" \
--number-of-final-designs 100
Output: 100-500 backbone PDBs
Phase 3: Sequence design
For RFdiffusion backbones
for backbone in backbones/*.pdb; do
modal run modal_ligandmpnn.py \
--input-pdb "$backbone" \
--params-str "--number_of_batches 8 --temperature 0.1"
done
Output: 8 sequences per backbone (800-4000 total)
Phase 4: Structure validation
Predict complexes
# Prepare FASTA with binder + target
# binder:target format for multimer
modal run modal_alphafold.py \
--input-fasta all_sequences.fasta \
--out-dir predictions/
Output: AF2 predictions with pLDDT, ipTM, PAE
Phase 5: Filtering and selection
Apply standard thresholds
import pandas as pd
# Load metrics
designs = pd.read_csv('all_metrics.csv')
# Filter
filtered = designs[
(designs['pLDDT'] > 0.85) &
(designs['ipTM'] > 0.50) &
(designs['PAE_interface'] < 10) &
(designs['scRMSD'] < 2.0) &
(designs['esm2_pll'] > 0.0)
]
# Rank by composite score
filtered['score'] = (
0.3 * filtered['pLDDT'] +
0.3 * filtered['ipTM'] +
0.2 * (1 - filtered['PAE_interface'] / 20) +
0.2 * filtered['esm2_pll']
)
top_designs = filtered.nlargest(50, 'score')
Output: 50-200 filtered candidates
Resource planning
Compute requirements
| Stage | GPU | Time (100 designs) |
|---|---|---|
| RFdiffusion | A10G | 30 min |
| ProteinMPNN | T4 | 15 min |
| Chai / AlphaFold | A100 | 4-8 hours |
| Filtering | CPU | 15 min |
Total timeline
- Small campaign (100 designs): 8-12 hours
- Medium campaign (500 designs): 24-48 hours
- Large campaign (1000+ designs): 2-5 days
Quality checkpoints
After backbone generation
- Visual inspection of diverse backbones
- Secondary structure present
- No clashes with target
After sequence design
- ESM2 PLL > 0.0 for most sequences
- No unwanted cysteines (unless intentional)
- Reasonable sequence diversity
After validation
- pLDDT > 0.85
- ipTM > 0.50
- PAE_interface < 10
- Self-consistency RMSD < 2.0 A
Final selection
- Diverse sequences (cluster if needed)
- Manufacturable (no problematic motifs)
- Reasonable molecular weight
Common issues
| Problem | Solution |
|---|---|
| Low ipTM | Check hotspots, increase designs |
| Poor diversity | Higher temperature, more backbones |
| High scRMSD | Backbone may be unusual |
| Low pLDDT | Check design quality |
Advanced workflows
Multi-tool combination
- RFdiffusion for initial backbones
- Mosaic for gradient-based refinement
- ProteinMPNN diversification
- AF2 final validation
Iterative refinement
- Run initial campaign
- Analyze failures
- Adjust hotspots/parameters
- Repeat with insights
What ships with it: 2 files
7.5 KB alongside SKILL.md
references/
- qc-checklist.md3.1 KB
- standard-pipeline.md4.4 KB
Gives 0 of the 12 instructions most design frontend skills give in ~1.2k tokens
Counted across 1,179 of the 2,086 authors here whose files we hold, read 2026-09-06
- Commit to a bold aesthetic directionin 31 of 1179, across 24 files
- Prefer component composition over inheritancein 28 of 1179, across 14 files
- Animate only transform and opacity propertiesin 27 of 1179, across 22 files
- Memoize expensive computations with useMemoin 26 of 1179, across 13 files
- Use semantic HTML elementsin 24 of 1179, across 23 files
- Virtualize long lists for performancein 21 of 1179, across 10 files
- Use CSS variables for design tokensin 20 of 1179, across 14 files
- Implement loading, empty, and error statesin 20 of 1179
- Lazy load heavy components with Suspensein 19 of 1179, across 8 files
- Respect prefers-reduced-motion media queriesin 18 of 1179, across 10 files
- Prioritize CSS-only animations for HTMLin 18 of 1179, across 16 files
- Use compound components for related UI elementsin 18 of 1179, across 7 files
Said here and by no other author read
- select three to six exposed residues as hotspots
- apply standard pLDDT and ipTM thresholds for filtering
- use ProteinMPNN for sequence design after backbone generation
- download target structure from PDB
- clean target structure and remove ligands
- generate backbones using RFdiffusion or BindCraft
Grouped from the skills themselves: near-identical wordings counted once, and counted by distinct author, so one author publishing three of these counts once. Length counted with cl100k_base; the agent that loads this file may tokenize it differently.