foldseek

star 10

Structure similarity search with Foldseek. Use this skill when: (1) Finding similar structures in PDB/AFDB databases, (2) Structural homology search, (3) Database queries by 3D structure, (4) Finding remote homologs not detected by sequence, (5) Clustering structures by similarity. For sequence similarity, use uniprot BLAST. For structure prediction, use chai or boltz.

BioTender-max By BioTender-max schedule Updated 3/4/2026

name: foldseek description: > Structure similarity search with Foldseek. Use this skill when: (1) Finding similar structures in PDB/AFDB databases, (2) Structural homology search, (3) Database queries by 3D structure, (4) Finding remote homologs not detected by sequence, (5) Clustering structures by similarity.

For sequence similarity, use uniprot BLAST. For structure prediction, use chai or boltz. license: MIT category: utilities tags: [search, structure, database, similarity] source: https://github.com/adaptyvbio/protein-design-skills

Foldseek Structure Search

Prerequisites

Requirement Minimum Recommended
RAM 8GB 16GB
Disk 10GB 50GB (local databases)

No GPU required.

How to run

Option 1: Web Server (Quick, rate-limited)

curl -X POST "https://search.foldseek.com/api/ticket" \
  -F "q=@query.pdb" \
  -F "database[]=afdb50" \
  -F "database[]=pdb100"

Option 2: Local installation

conda install -c conda-forge -c bioconda foldseek

# Search PDB
foldseek easy-search query.pdb /path/to/pdb100 results.m8 tmp/

# Search AlphaFold DB
foldseek easy-search query.pdb /path/to/afdb50 results.m8 tmp/

Key Parameters

Parameter Default Description
--min-seq-id 0.0 Minimum sequence identity
-e 0.001 E-value threshold
--alignment-type 2 0=3Di, 1=TM, 2=3Di+AA

Databases

Database Description Size
pdb100 PDB clustered at 100% ~200K structures
afdb50 AlphaFold DB at 50% ~67M structures
swissprot SwissProt structures ~500K structures

Common Use Cases

Novelty check

foldseek easy-search design.pdb afdb50 novelty.m8 tmp/
# Novel if: top hit identity < 30%

Find similar natural structures

foldseek easy-search design.pdb pdb100 similar_natural.m8 tmp/

Scaffold search for motif grafting

foldseek easy-search motif.pdb pdb100 scaffolds.m8 tmp/ \
  --min-seq-id 0.0 -e 10

Decision Tree

Searching by?
├─ 3D structure → Foldseek ✓
├─ Sequence → Use BLAST (uniprot skill)
└─ Both → Run both, compare results

Troubleshooting

Error Cause Fix
No hits Too strict cutoff Lower e-value, try larger database
Database not found Wrong path Check database location
Out of memory Large database Use web server

Next: Download hits with pdb skill → use for scaffold design.

Install via CLI
npx skills add https://github.com/BioTender-max/ProteinClaw --skill foldseek
Repository Details
star Stars 10
call_split Forks 0
navigation Branch main
article Path SKILL.md
More from Creator
BioTender-max
BioTender-max Explore all skills →