adaptyvbio/protein-design-skills/protein-design-workflow

Claude Code and agent skill by adaptyvbio/protein-design-skills

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

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.

Install

npx vskill@latest install adaptyvbio/protein-design-skills/protein-design-workflow

SKILL.md

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
bash
# Download from PDB
curl -o target.pdb "https://files.rcsb.org/download/XXXX.pdb"
1.2 Clean and prepare
python
# 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)
bash
# 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)
bash
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
bash
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
bash
# 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
python
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
StageGPUTime (100 designs)
RFdiffusionA10G30 min
ProteinMPNNT415 min
Chai / AlphaFoldA1004-8 hours
FilteringCPU15 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

ProblemSolution
Low ipTMCheck hotspots, increase designs
Poor diversityHigher temperature, more backbones
High scRMSDBackbone may be unusual
Low pLDDTCheck design quality

Advanced workflows

Multi-tool combination
  1. RFdiffusion for initial backbones
  2. Mosaic for gradient-based refinement
  3. ProteinMPNN diversification
  4. AF2 final validation
Iterative refinement
  1. Run initial campaign
  2. Analyze failures
  3. Adjust hotspots/parameters
  4. Repeat with insights

Security

  • Security scanPassed, 95 of 100Pattern checks on the skill's files.
  • Model reviewPassed

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

Source

Popularity

Repository stars
142
Repository forks
16
7-day trend score
25

Stars and forks are for the whole GitHub repository, not this skill alone. Refreshed 29 Mar 2026, 7 months ago.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/adaptyvbio/protein-design-skills/protein-design-workflow/badge)](https://verified-skill.com/skills/adaptyvbio/protein-design-skills/protein-design-workflow)

Something wrong with this skill or its page? Tell us.