boltz-protein-design

Design de novo protein, peptide, antibody, and nanobody binders via the Boltz API.

5.3k|765|Updated Mar 4, 2026
One-click install
npx skills add https://github.com/openai/plugins --skill boltz-protein-design
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: boltz-protein-design
Source: https://github.com/openai/plugins/tree/main/plugins/boltz-api-cli/skills/boltz-protein-design
Command: npx skills add https://github.com/openai/plugins --skill boltz-protein-design

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gemmi, numpy, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Designing new protein binders against a target requires authoring complex API payloads, choosing scaffold and crop configurations, sizing expensive generation campaigns, and ranking thousands of outputs. This Skill guides the full Boltz protein:design workflow so binders are generated, costed, and ranked correctly.

Core Features & Use Cases

  • Payload authoring and submission: Builds protein:design payloads with target normalization, binder_specification variants (boltz_curated, structure_template, no_template), sequence DSL, and optional design rules, then runs estimate-cost and start through the boltz-api CLI.
  • Target exploration: Scouts crop radii, disorder cutouts, domains, and binding sites with 50-design runs using bundled gemmi/numpy scripts before committing to a full campaign.
  • Cost gating and ranking: Enforces an explicit spending gate before every paid run and ranks downloaded results by binding_confidence with iptm and min_interaction_pae tiebreakers.
  • Use Case: A researcher wants nanobody binders against a new multi-domain target. The Skill recommends an exploration pass, scouts domain and site configurations in parallel, picks the winner by max binding_confidence, then submits a 50,000-design campaign after cost confirmation.

Quick Start

Use the boltz-protein-design skill to design nanobody binders against my target CIF file, starting with a target-exploration pass and confirming the estimated cost before submitting.

Frequently Asked Questions about boltz-protein-design

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I design protein binders with the Boltz API?

Author a protein:design payload with num_proteins, a target (structure_template or no_template), and a binder_specification, then run boltz-api protein:design estimate-cost followed by start. Download results with download-results and rank by binding_confidence.

How many designs should I generate in a Boltz binder campaign?

The valid range is 10 to 1,000,000, but 10 is only a test size. Recommended campaign tiers are 20,000 for a small screen, 50,000 as the default medium campaign, and 100,000 for hard targets needing maximal coverage.

What is the boltz_curated binder specification for antibody design?

boltz_curated lets Boltz select from maintained antibody or nanobody scaffold template lists during design. Use binder: boltz_antibody for antibody/Fab requests and binder: boltz_nanobody for nanobody/VHH requests, without specifying a modality.

Does the Boltz design skill support exploring unknown binding sites?

Yes, a target-exploration pass scouts configurations with 50-design runs across crop radii, disorder cutouts, and domains. For targets over 300 residues with unknown sites, a 100-design scan run clusters binder contact footprints to discover candidate sites.

Why is my protein design run rejected with a validation error?

The server rejects num_proteins below 10 or above 1,000,000 with a VALIDATION_ERROR. Validate the count client-side before calling estimate-cost, and ensure residue indices are 0-based and payload fields use exact API body names.

How do I rank Boltz protein design results after download?

Rank entries in results/index.jsonl by binding_confidence descending, using iptm (higher better) and min_interaction_pae (lower better) as tiebreakers. Do not sort by optimization_score, which is not emitted for protein:design.