Agent skill

Protein Design Workflow

by adaptyvbio in adaptyvbio/protein-design-skills

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

MITAuto-check passedResearch & Science

Install Protein Design Workflow

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

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

GitHub CLI
$ gh skill install adaptyvbio/protein-design-skills protein-design-workflow --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/protein-design-workflow .claude/skills/protein-design-workflow && 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
protein-design-workflow
GitHub stars
164
Used in
3 other repos
Token cost
~1.2k tokens
SKILL.md length
273 words
Files
3 (incl. references)
Skills in repo
24
Repo updated
First seen
Licence
MIT

At a glance

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

  • Works in 5 steps: Target preparation → Backbone generation → Sequence design → …
  • Starting a new protein design project
  • SKILL.md covers Standard binder design pipeline, Phase 1: Target preparation, Phase 2: Backbone generation and Phase 3: Sequence design, plus 6 more sections
  • Calls modal, curl and python; reaches files.rcsb.org

What it does

Protein Design Workflow is an agent skill from adaptyvbio/protein-design-skills. 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.

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including reference files (for example `references/qc-checklist.md` and `references/standard-pipeline.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

  • Starting a new protein design project
  • Need step-by-step workflow guidance
  • Understanding the full design pipeline
  • Planning compute resources and timelines

Example prompts

  • “/protein-design-workflow”

Requirements

  • Python 3

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Target preparation
  2. Backbone generation
  3. Sequence design
  4. Structure validation
  5. Filtering and selection

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
    • curl
    • 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:

    • files.rcsb.org

    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

Protein Design Workflow loads about 1.2k tokens when it runs, and up to ~3.2k if it reads all its reference files. Until then it costs about 95 tokens; SKILL.md has 273 words of instructions outside code blocks.

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

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). 273 words, ~1,242 tokens.

Download SKILL.mdSave it as .claude/skills/protein-design-workflow/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
protein-design-workflow
description
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.
license
MIT
category
orchestration
tags
guidance, pipeline, workflow

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

© 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/protein-design-workflow of adaptyvbio/protein-design-skills.

  • SKILL.md
  • references/qc-checklist.md
  • references/standard-pipeline.md

Open the folder on GitHubat commit 59dd633

Used in 3 other repositories

We found 3 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 3 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

Protein Design Workflow 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.

Protein Design Workflow compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Protein Design Workflow this skilladaptyvbio/protein-design-skills1643 repos~1.2kAutomated safety check: PassMIT
Alphafold Database Fetch And Analyzegoogle-deepmind/science-skills3.2k2 repos~1.2kAutomated safety check: PassApache-2.0
Pymol VisualizationChatMol/ChatMol373—~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.

    373 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 8 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.

    164 GitHub starsUsed in 3 repos~1.2k tokens
    Auto-check passed
  • Bindcraft

    adaptyvbio/protein-design-skills

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

    164 GitHub starsUsed in 3 repos~1.3k tokens
    Auto-check passed
  • Binder Design

    adaptyvbio/protein-design-skills

    Guidance for choosing the right protein binder design tool. An agent skill from adaptyvbio/protein-design-skills.

    164 GitHub starsUsed in 3 repos~1.8k 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.

    164 GitHub starsUsed in 3 repos~2k tokens
    Auto-check passed
  • Chai

    adaptyvbio/protein-design-skills

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

    164 GitHub starsUsed in 3 repos~1.5k tokens
    Auto-check passed
  • Protein Qc

    adaptyvbio/protein-design-skills

    Quality control metrics and filtering thresholds for protein design.

    164 GitHub starsUsed in 3 repos~3.2k tokens
    Auto-check passed

Questions about Protein Design Workflow

What does Protein Design Workflow do?

End-to-end guidance for protein design pipelines. An agent skill from adaptyvbio/protein-design-skills. Protein Design Workflow is an agent skill from adaptyvbio/protein-design-skills. End-to-end guidance for protein design pipelines.

When should I use Protein Design Workflow?

Protein Design Workflow fits situations like: starting a new protein design project; need step-by-step workflow guidance; understanding the full design pipeline; planning compute resources and timelines.

How do I install Protein Design Workflow in Claude Code?

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

How do I install Protein Design Workflow in Codex?

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

Can I use Protein Design Workflow 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 protein-design-workflow -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/protein-design-workflow, .gemini/skills/protein-design-workflow, .github/skills/protein-design-workflow and .opencode/skills/protein-design-workflow in your project.

What does Protein Design Workflow need to run?

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

Does Protein Design Workflow access the network?

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

Is Protein Design Workflow 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 Protein Design Workflow use?

Protein Design Workflow 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 Protein Design Workflow use?

About 1.2k tokens (SKILL.md is roughly 5k 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.9k tokens, read only when the agent opens those files.

What are the alternatives to Protein Design Workflow?

Skills that share tags, products or a category with Protein Design Workflow: Alphafold Database Fetch And Analyze (google-deepmind/science-skills, 3.2k stars), Pymol Visualization (ChatMol/ChatMol, 373 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 Protein Design Workflow?

adaptyvbio (a GitHub organization) maintains it in adaptyvbio/protein-design-skills, which has 164 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.