Validate protein designs using AlphaFold2 structure prediction.

MITAuto-check passedResearch & Science

Install Alphafold

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

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

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

At a glance

Validate protein designs using AlphaFold2 structure prediction.

  • Validating designed sequences fold correctly
  • SKILL.md covers Prerequisites, How to run, Key parameters and Output format, plus 5 more sections
  • Calls python, modal and git; reaches github.com
  • Predicting binder-target complex structures

What it does

Alphafold is an agent skill from adaptyvbio/protein-design-skills. Validate protein designs using AlphaFold2 structure prediction. Use this skill when: (1) Validating designed sequences fold correctly, (2) Predicting binder-target complex structures, (3) Calculating confidence metrics (pLDDT, pTM, ipTM), (4) Self-consistency validation of designs, (5) Multi-chain complex prediction with AlphaFold-Multimer. For faster single-chain prediction, use esm. 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 2 other files, including reference files (for example `references/multimer.md`).

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

When your agent uses it

  • Validating designed sequences fold correctly
  • Predicting binder-target complex structures
  • Calculating confidence metrics (pLDDT
  • Self-consistency validation of designs

Example prompts

  • “/alphafold”

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:

    • python
    • modal
    • git
    • uv

    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

Alphafold loads about 1.2k tokens when it runs, and up to ~2.1k if it reads all its reference files. Until then it costs about 108 tokens; SKILL.md has 231 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~108
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
~2.1k

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). 231 words, ~1,183 tokens.

Download SKILL.mdSave it as .claude/skills/alphafold/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
alphafold
description
Validate protein designs using AlphaFold2 structure prediction. Use this skill when: (1) Validating designed sequences fold correctly, (2) Predicting binder-target complex structures, (3) Calculating confidence metrics (pLDDT, pTM, ipTM), (4) Self-consistency validation of designs, (5) Multi-chain complex prediction with AlphaFold-Multimer. For faster single-chain prediction, use esm. For QC thresholds, use protein-qc.
license
MIT
category
design-tools
tags
structure-prediction, validation, reference
biomodals_script
modal_alphafold.py

AlphaFold2 Structure Validation

Prerequisites

RequirementMinimumRecommended
Python3.8+3.10
CUDA11.0+12.0+
GPU VRAM32GB40GB (A100)
RAM32GB64GB
Disk100GB500GB (for databases)

How to run

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

Option 1: Modal (AlphaFold-Multimer)
bash
cd biomodals
modal run modal_alphafold.py \
  --input-fasta sequences.fasta \
  --out-dir output/

GPU: A100 (40GB) | Timeout: 3600s default

Option 2: Local installation
bash
git clone https://github.com/google-deepmind/alphafold.git
cd alphafold

python run_alphafold.py \
  --fasta_paths=query.fasta \
  --output_dir=output/ \
  --model_preset=monomer \
  --max_template_date=2026-01-01
Option 3: ESMFold2 (fast single-sequence)
bash
printf '>protein|A\nMKTAYIAKQRQISFVK...\n' > seq.faa
uv run --with modal modal run modal_esmfold2.py --input-faa seq.faa

Key parameters

ParameterDefaultOptionsDescription
--model_presetmonomermonomer/multimerModel type
--num_recycle31-20Recycling iterations
--max_template_date-YYYY-MM-DDTemplate cutoff
--use_templatesTrueTrue/FalseUse template search

Output format

output/
├── ranked_0.pdb           # Best model
├── ranked_1.pdb           # Second best
├── ranking_debug.json     # Confidence scores
├── result_model_1.pkl     # Full results
├── msas/                  # MSA files
└── features.pkl           # Input features
Extracting metrics
python
import pickle

with open('result_model_1.pkl', 'rb') as f:
    result = pickle.load(f)

plddt = result['plddt']
ptm = result['ptm']
iptm = result.get('iptm', None)  # Multimer only
pae = result['predicted_aligned_error']

Sample output

Successful run
$ python run_alphafold.py --fasta_paths complex.fasta --model_preset multimer
[INFO] Running MSA search...
[INFO] Running model 1/5...
[INFO] Running model 5/5...
[INFO] Relaxing structures...

Results:
  ranked_0.pdb:
    pLDDT: 87.3 (mean)
    pTM: 0.78
    ipTM: 0.62
    PAE (interface): 8.5

Saved to output/

What good output looks like:

  • pLDDT: > 85 (mean, on 0-100 scale) or > 0.85 (normalized)
  • pTM: > 0.70
  • ipTM: > 0.50 for complexes
  • PAE_interface: < 10

Decision tree

Should I use AlphaFold?
│
├─ What are you predicting?
│  ├─ Single protein → ESMFold (faster)
│  ├─ Protein-protein complex → AlphaFold/ColabFold ✓
│  ├─ Protein + ligand → Chai or Boltz
│  └─ Batch of sequences → ColabFold ✓
│
├─ What do you need?
│  ├─ Highest accuracy → AlphaFold/ColabFold ✓
│  ├─ Fast screening → ESMFold
│  └─ MSA-free prediction → Chai or ESMFold
│
└─ Which AF2 option?
   ├─ Local installation → Full control, slow setup
   ├─ ColabFold → Easier, MSA server
   └─ Modal → Recommended for batch

Typical performance

Campaign SizeTime (A100)Cost (Modal)Notes
100 complexes1-2h~$8With MSA server
500 complexes5-10h~$40Standard campaign
1000 complexes10-20h~$80Large campaign

Per-complex: ~30-60s with MSA server.


Verify

bash
find output -name "ranked_0.pdb" | wc -l  # Should match input count

Troubleshooting

Low pLDDT regions: May indicate disorder or poor design Low ipTM: Interface not confident, check hotspots High PAE off-diagonal: Chains may not interact OOM errors: Use ColabFold with MSA server instead

Error interpretation
ErrorCauseFix
RuntimeError: CUDA out of memorySequence too longUse A100 or split prediction
KeyError: 'iptm'Running monomer on complexUse multimer preset
FileNotFoundError: databaseMissing MSA databasesUse ColabFold MSA server
TimeoutErrorMSA search slowReduce num_recycles

Next: protein-qc for filtering and ranking.

© 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 1 other file (references) in skills/alphafold of adaptyvbio/protein-design-skills.

  • SKILL.md
  • references/multimer.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

Alphafold 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.

Alphafold compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Alphafold this skilladaptyvbio/protein-design-skills1634 repos~1.2kAutomated safety check: PassMIT
Alphafold Database Fetch And Analyzegoogle-deepmind/science-skills3.2k2 repos~1.2kAutomated safety check: PassApache-2.0
Biopipelineslocbp-uzh/biopipelines109—~2.4kAutomated safety check: PassMIT
Bio DB ToolsDrugClaw/DrugClaw125—~1.4kAutomated safety check: PassApache-2.0
Ggetdavila7/claude-code-templates32k11 repos~6.3kAutomated safety check: PassMIT
Alphafold Databasedavila7/claude-code-templates32k10 repos~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
  • 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
  • Bio DB Tools

    DrugClaw/DrugClaw

    Query public biology databases and APIs including UniProt, RCSB PDB, AlphaFold DB, ClinVar, dbSNP, gnomAD, Ensembl, GEO, InterPro, KEGG, OpenTargets, Reactome, and STRING.

    125 GitHub stars~1.4k tokensUpdated 6 mo ago
    Research & ScienceAuto-check passed
  • Gget

    davila7/claude-code-templates

    CLI/Python toolkit for rapid bioinformatics queries. An agent skill from davila7/claude-code-templates.

    32k GitHub starsUsed in 11 repos~6.3k tokens
    Research & ScienceAuto-check passed
  • Alphafold Database

    davila7/claude-code-templates

    Access AlphaFold's 200M+ AI-predicted protein structures. An agent skill from davila7/claude-code-templates.

    32k GitHub starsUsed in 10 repos~4k tokens
    Research & ScienceAuto-check passed
  • Pymol

    google-deepmind/science-skills

    Visualize, analyze, and render protein and molecular structures using PyMOL.

    3.2k GitHub starsUsed in 2 repos~1.6k tokens
    Research & ScienceAuto-check passed

More from adaptyvbio/protein-design-skills

All 24 skills in this repo
  • Bindcraft

    adaptyvbio/protein-design-skills

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

    163 GitHub starsUsed in 4 repos~1.3k 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

Works with

Questions about Alphafold

What does Alphafold do?

Validate protein designs using AlphaFold2 structure prediction. Alphafold is an agent skill from adaptyvbio/protein-design-skills. Validate protein designs using AlphaFold2 structure prediction.

When should I use Alphafold?

Alphafold fits situations like: validating designed sequences fold correctly; predicting binder-target complex structures; calculating confidence metrics (pLDDT; self-consistency validation of designs.

How do I install Alphafold in Claude Code?

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

How do I install Alphafold in Codex?

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

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

What does Alphafold need to run?

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

Does Alphafold 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 Alphafold 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 Alphafold use?

Alphafold 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 Alphafold use?

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

What are the alternatives to Alphafold?

Skills that share tags, products or a category with Alphafold: Alphafold Database Fetch And Analyze (google-deepmind/science-skills, 3.2k stars), Biopipelines (locbp-uzh/biopipelines, 109 stars), Bio DB Tools (DrugClaw/DrugClaw, 125 stars) and Gget (davila7/claude-code-templates, 32k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Alphafold?

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.