End-to-end binder design using BindCraft hallucination. An agent skill from adaptyvbio/protein-design-skills.

MITAuto-check passedResearch & Science

Install Bindcraft

skills CLI
$ npx skills add adaptyvbio/protein-design-skills --skill bindcraft -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install adaptyvbio/protein-design-skills bindcraft --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/adaptyvbio/protein-design-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/bindcraft .claude/skills/bindcraft && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
bindcraft
GitHub stars
163
Used in
4 other repos
Token cost
~1.3k tokens
SKILL.md length
277 words
Files
3 (incl. references)
Skills in repo
24
Repo updated
First seen
Licence
MIT

At a glance

End-to-end binder design using BindCraft hallucination. An agent skill from adaptyvbio/protein-design-skills.

  • Designing protein binders with built-in AF2 validation
  • SKILL.md covers Prerequisites, How to run, Key parameters (Modal wrapper) and Output format, plus 5 more sections
  • Calls modal, git and python; reaches github.com
  • Running production-quality binder campaigns

What it does

Bindcraft is an agent skill from adaptyvbio/protein-design-skills. End-to-end binder design using BindCraft hallucination. Use this skill when: (1) Designing protein binders with built-in AF2 validation, (2) Running production-quality binder campaigns, (3) Using different design protocols (fast, default, slow), (4) Need joint backbone and sequence optimization, (5) Want high experimental success rate. For backbone-only generation, use rfdiffusion. For QC thresholds, use protein-qc. For tool selection guidance, use binder-design.

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including reference files (for example `references/protocols.md` and `references/troubleshooting.md`).

It sits in Research & Science, covering Protein structure and design. The repository describes itself as: Claude Code skills for protein design. The licence is MIT.

When your agent uses it

  • Designing protein binders with built-in AF2 validation
  • Running production-quality binder campaigns
  • Using different design protocols (fast
  • Need joint backbone and sequence optimization

Example prompts

  • “/bindcraft”

Requirements

  • Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit 59dd633. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • modal
    • git
    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Bindcraft loads about 1.3k tokens when it runs, and up to ~2.5k if it reads all its reference files. Until then it costs about 119 tokens; SKILL.md has 277 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~119
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from adaptyvbio/protein-design-skills at commit 59dd633, republished under its MIT licence (© adaptyvbio). 277 words, ~1,321 tokens.

Download SKILL.mdSave it as .claude/skills/bindcraft/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
bindcraft
description
End-to-end binder design using BindCraft hallucination. Use this skill when: (1) Designing protein binders with built-in AF2 validation, (2) Running production-quality binder campaigns, (3) Using different design protocols (fast, default, slow), (4) Need joint backbone and sequence optimization, (5) Want high experimental success rate. For backbone-only generation, use rfdiffusion. For QC thresholds, use protein-qc. For tool selection guidance, use binder-design.
license
MIT
category
design-tools
tags
structure-design, sequence-design, binder, pipeline
proteinbase_slug
bindcraft
proteinbase_url
https://proteinbase.com/design-methods/bindcraft
biomodals_script
modal_bindcraft.py

BindCraft Binder Design

Prerequisites

RequirementMinimumRecommended
Python3.9+3.10
CUDA11.7+12.0+
GPU VRAM32GB48GB (L40S)
RAM32GB64GB

How to run

First time? See Getting started to set up Modal and biomodals.

bash
cd biomodals
modal run modal_bindcraft.py \
  --input-pdb target.pdb \
  --target-chains A \
  --target-hotspot-residues "45,67,89" \
  --lengths "70,100" \
  --number-of-final-designs 50

GPU: L40S (48GB) | Timeout: 300 min default

Option 2: Local installation
bash
git clone https://github.com/martinpacesa/BindCraft.git
cd BindCraft

# BindCraft is configured with JSON files, not flags
python -u ./bindcraft.py \
  --settings ./settings_target/mytarget.json \
  --filters ./settings_filters/default_filters.json \
  --advanced ./settings_advanced/default_4stage_multimer.json

The target PDB, chains, hotspots, and binder length range are set inside the --settings JSON. See the BindCraft repo for the settings schema.

Key parameters (Modal wrapper)

ParameterDefaultDescription
--input-pdbrequiredTarget structure
--target-chainsATarget chain(s)
--target-hotspot-residues""Target hotspots (e.g. "45,67,89")
--lengths50,130Binder length range
--number-of-final-designs1Passing designs to return
--max-trajectoriesnoneCap on trajectories

Output format

output/
├── design_0/
│   ├── binder.pdb         # Final design
│   ├── complex.pdb        # Binder + target
│   ├── metrics.json       # QC scores
│   └── trajectory/        # Optimization trajectory
├── design_1/
│   └── ...
└── summary.csv            # All metrics
Metrics Output
json
{
  "plddt": 0.89,
  "ptm": 0.78,
  "iptm": 0.62,
  "pae": 8.5,
  "rmsd": 1.2,
  "sequence": "MKTAYIAK..."
}

Sample output

Successful run
$ modal run modal_bindcraft.py --input-pdb target.pdb --target-chains A --target-hotspot-residues "45,67,89" --number-of-final-designs 50
[INFO] Loading BindCraft model...
[INFO] Target: target.pdb (chain A)
[INFO] Hotspots: 45, 67, 89
[INFO] Generating designs...

Design 1/50:
  Length: 78 AA
  pLDDT: 0.89, ipTM: 0.62
  Saved: output/design_0/

Design 50/50:
  Length: 85 AA
  pLDDT: 0.86, ipTM: 0.58
  Saved: output/design_49/

[INFO] Campaign complete. Summary: output/summary.csv
Pass rate: 32/50 (64%) with ipTM > 0.5

What good output looks like:

  • pLDDT: > 0.85 for most designs
  • ipTM: > 0.5 for passing designs
  • Pass rate: 30-70% depending on target
  • Diverse sequences across designs

Decision tree

Should I use BindCraft?
│
├─ What type of design?
│  ├─ Production-quality binders → BindCraft ✓
│  ├─ High diversity exploration → RFdiffusion
│  └─ All-atom precision → BoltzGen
│
├─ What matters most?
│  ├─ Experimental success rate → BindCraft ✓
│  ├─ Speed / diversity → RFdiffusion + ProteinMPNN
│  ├─ AF2 gradient optimization → ColabDesign
│  └─ All-atom control → BoltzGen
│
└─ Compute resources?
   ├─ Have L40S/A100 → BindCraft ✓
   └─ Only A10G → RFdiffusion + ProteinMPNN

Typical performance

Campaign SizeTime (L40S)Cost (Modal)Notes
50 designs2-4h~$15Quick campaign
100 designs4-8h~$30Standard
200 designs8-16h~$60Large campaign

Adaptyv's own tests of these models showed BindCraft costing about $2.90 per accepted design, averaged across 7 targets.

Experimental success rate (BindCraft paper): 10 to 100%, averaging 46.3% across 12 targets; strongly target-dependent.


Verify

bash
find output -name "binder.pdb" | wc -l  # Should match num_designs

Troubleshooting

Low ipTM scores: Check hotspot selection, increase designs Slow convergence: Use fast protocol for screening OOM errors: Reduce num_models, use L40S GPU Poor diversity: Lower sampling_temp, run multiple seeds

Error interpretation
ErrorCauseFix
RuntimeError: CUDA out of memoryLarge target or long binderUse L40S/A100, reduce binder length
ValueError: no hotspotsHotspots not foundCheck residue numbering
TimeoutErrorDesign taking too longUse fast protocol

Next: Rank by ipsae → experimental validation.

© adaptyvbio, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (references) in skills/bindcraft of adaptyvbio/protein-design-skills.

  • SKILL.md
  • references/protocols.md
  • references/troubleshooting.md

Open the folder on GitHubat commit 59dd633

Used in 4 other repositories

We found 6 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 4 other GitHub owners. This page covers the copy in adaptyvbio/protein-design-skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Bindcraft next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Bindcraft compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Bindcraft this skilladaptyvbio/protein-design-skills1634 repos~1.3kAutomated safety check: PassMIT
Alphafold Database Fetch And Analyzegoogle-deepmind/science-skills3.2k2 repos~1.2kAutomated safety check: PassApache-2.0
Pymol VisualizationChatMol/ChatMol372—~1.2kAutomated safety check: PassMIT
Complexa Binder DesignNVIDIA-BioNeMo/bionemo-agent-toolkit478—~3.1kAutomated safety check: NotesApache-2.0
DiffDock Molecular DockingK-Dense-AI/scientific-agent-skills48k1 repos~3kAutomated safety check: NotesMIT
Biopipelineslocbp-uzh/biopipelines109—~2.4kAutomated safety check: PassMIT

Similar skills

  • Alphafold Database Fetch And Analyze

    google-deepmind/science-skills

    Retrieve and analyze AlphaFold predicted structures for a protein.

    3.2k GitHub starsUsed in 2 repos~1.2k tokens
    Research & ScienceAuto-check passed
  • Pymol Visualization

    ChatMol/ChatMol

    Generate publication-quality molecular visualization images using PyMOL.

    372 GitHub stars~1.2k tokensUpdated 6 mo ago
    Research & ScienceAuto-check passed
  • Complexa Binder Design

    NVIDIA-BioNeMo/bionemo-agent-toolkit

    Run a complete protein binder design campaign with NVIDIA Proteina-Complexa: resolve a target structure and hotspots from a name/sequence/PDB, co-design binder sequence+structure with reward-guided…

    478 GitHub stars~3.1k tokensUpdated today
    Research & ScienceAuto-check: notes
  • DiffDock Molecular Docking

    K-Dense-AI/scientific-agent-skills

    Predicts how small molecules bind to a protein with DiffDock, covering batch docking, pose ranking by confidence and checks on the results; not for binding affinity.

    48k GitHub starsUsed in 1 repo~3k tokens
    Research & ScienceAuto-check: notes
  • Biopipelines

    locbp-uzh/biopipelines

    Design and run computational protein and ligand workflows on a GPU: binder and enzyme design, de novo backbone generation, inverse folding and sequence redesign, structure prediction, protein-ligand…

    109 GitHub stars~2.4k tokensUpdated 7 days ago
    Research & ScienceAuto-check passed
  • Protein Binder Design

    NVIDIA-BioNeMo/bionemo-agent-toolkit

    Orchestrate an end-to-end de novo protein binder design campaign against a protein target by composing BioNeMo NIM skills.

    478 GitHub stars~1.4k tokensUpdated today
    Research & ScienceAuto-check: notes

More from adaptyvbio/protein-design-skills

All 24 skills in this repo
  • Alphafold

    adaptyvbio/protein-design-skills

    Validate protein designs using AlphaFold2 structure prediction.

    163 GitHub starsUsed in 4 repos~1.2k tokens
    Auto-check passed
  • Boltzgen

    adaptyvbio/protein-design-skills

    All-atom protein design using BoltzGen diffusion model. An agent skill from adaptyvbio/protein-design-skills.

    163 GitHub starsUsed in 4 repos~2k tokens
    Auto-check passed
  • Chai

    adaptyvbio/protein-design-skills

    Structure prediction using Chai-1, a foundation model for molecular structure.

    163 GitHub starsUsed in 4 repos~1.5k tokens
    Auto-check passed
  • Protein Design Workflow

    adaptyvbio/protein-design-skills

    End-to-end guidance for protein design pipelines. An agent skill from adaptyvbio/protein-design-skills.

    163 GitHub starsUsed in 4 repos~1.2k tokens
    Auto-check passed
  • Protein Qc

    adaptyvbio/protein-design-skills

    Quality control metrics and filtering thresholds for protein design.

    163 GitHub starsUsed in 4 repos~3.2k tokens
    Auto-check passed
  • Proteinmpnn

    adaptyvbio/protein-design-skills

    Design protein sequences using ProteinMPNN inverse folding. An agent skill from adaptyvbio/protein-design-skills.

    163 GitHub starsUsed in 4 repos~1.8k tokens
    Auto-check passed

Questions about Bindcraft

What does Bindcraft do?

End-to-end binder design using BindCraft hallucination. An agent skill from adaptyvbio/protein-design-skills. Bindcraft is an agent skill from adaptyvbio/protein-design-skills. End-to-end binder design using BindCraft hallucination.

When should I use Bindcraft?

Bindcraft fits situations like: designing protein binders with built-in AF2 validation; running production-quality binder campaigns; using different design protocols (fast; need joint backbone and sequence optimization.

How do I install Bindcraft in Claude Code?

Run `npx skills add adaptyvbio/protein-design-skills --skill bindcraft -a claude-code`. Or copy the skill folder (skills/bindcraft in adaptyvbio/protein-design-skills) into .claude/skills/bindcraft in your project. Claude Code loads it when a task matches its description.

How do I install Bindcraft in Codex?

Run `npx skills add adaptyvbio/protein-design-skills --skill bindcraft -a codex`. Or copy the skill folder (skills/bindcraft in adaptyvbio/protein-design-skills) into .agents/skills/bindcraft in your project. Codex loads it when a task matches its description.

Can I use Bindcraft in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add adaptyvbio/protein-design-skills --skill bindcraft -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/bindcraft, .gemini/skills/bindcraft, .github/skills/bindcraft and .opencode/skills/bindcraft in your project.

What does Bindcraft need to run?

Going by SKILL.md and its folder, Bindcraft needs the command-line tools its instructions call (modal, git and python). Our summary lists: Python 3.

Does Bindcraft access the network?

SKILL.md names 1 domain. In commands or code: github.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Bindcraft safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Bindcraft use?

Bindcraft is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Bindcraft use?

About 1.3k tokens (SKILL.md is roughly 5.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.2k tokens, read only when the agent opens those files.

What are the alternatives to Bindcraft?

Skills that share tags, products or a category with Bindcraft: Alphafold Database Fetch And Analyze (google-deepmind/science-skills, 3.2k stars), Pymol Visualization (ChatMol/ChatMol, 372 stars), Complexa Binder Design (NVIDIA-BioNeMo/bionemo-agent-toolkit, 478 stars) and DiffDock Molecular Docking (K-Dense-AI/scientific-agent-skills, 48k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Bindcraft?

adaptyvbio (a GitHub organization) maintains it in adaptyvbio/protein-design-skills, which has 163 GitHub stars. The repository holds 24 skills in this directory. The repository was last updated on June 11, 2026.

Source: adaptyvbio/protein-design-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.