Skip to content
Skills Library
Science & research · Research

foldseek

/foldseek

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.

Licence
MIT
Last repository change
21.07.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
1
Deprecation

No signals detected. Repository changed on 21.07.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

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.

Original author 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.

How it works

  1. Prerequisites
  2. How to run
  3. Key parameters
  4. Databases
  5. Output format
  6. Sample output
  7. Decision tree
  8. Common use cases
  9. Verify
  10. Troubleshooting
Original SKILL.md headings · 164 lines, 588 words
SKILL.md preview
---
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]
---

# Foldseek Structure Search

## Prerequisites

| Requirement | Minimum | Recommended |
|-------------|---------|-------------|
| Python | 3.8+ | 3.10 |
| RAM | 8GB | 16GB |
| Disk | 10GB | 50GB (for local databases) |

## How to run

**Note**: Foldseek can run locally or via web server. No GPU required.

### Option 1: Web Server (Quick; rate-limited, use sparingly)
```bash
# Upload structure to web server
curl -X POST "https://search.foldseek.com/api/ticket" \
  -F "q=@query.pdb" \
  -F "database[]=afdb50" \
  -F "database[]=pdb100"
```

### Option 2: Local installation
```bash
# Install Foldseek
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/
```

### Option 3: Python API
```python
import subprocess
import pandas as pd

def foldseek_search(query_pdb, database, output="results.m8"):
    """Run Foldseek search."""
    subprocess.run([
        "foldseek", "easy-search",
        query_pdb, database, output, "tmp/",
        "--format-output", "query,target,pident,alnlen,evalue,bits"
    ])
    return pd.read_csv(output, sep="\t",
                       names=["query", "target", "pident", "alnlen", "evalue", "bits"])
```

## 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 |
| `--max-seqs` | 300 | Max hits to pass through prefilter; reducing this affects sensitivity |

## Databases

| Database | Description | Size |
|----------|-------------|------|
| `pdb100` | PDB clustered at 100% | ~200K structures |
| `afdb50` | AlphaFold DB at 50% | ~67M structures |
| `swissprot` | SwissProt structures | ~500K structures |
| `cath50` | CATH domains | ~50K domains |

## Output format

```
# results.m8 (tabular)
query   target          pident  alnlen  evalue  bits
query   1abc_A          85.2    120     1e-45   180.5
query   2def_B          72.1    115     1e-32   145.2
```

## Sample output

### Successful run
```
$ foldseek easy-search query.pdb pdb100 results.m8 tmp/
[INFO] Loading database: pdb100 (194,527 entries)
[INFO] Searching...
[INFO] Found 127 hits

Top 5 hits:
1. 1abc_A - 85.2% identity, E=1e-45
2. 2def_B - 72.1% identity, E=1e-32
3. 3ghi_C - 68.5% identity, E=1e-28
4. 4jkl_A - 55.3% identity, E=1e-18
5. 5mno_B - 42.1% identity, E=1e-10
```

## Decision tree

```
Should I use Foldseek?
│
├─ What are you searching?
│  ├─ By 3D structure → Foldseek ✓
│  ├─ By sequence → Use BLAST (uniprot skill)
│  └─ Both → Run both, compare results
│
└─ What do you need?
   ├─ Find structural homologs → Foldseek ✓
   ├─ Remote homolog detection → Foldseek ✓
   ├─ Structural clustering → Foldseek ✓
   └─ Functional annotation → Cross-reference with UniProt
```

## Common use cases

### Find similar designs
```bash
# Compare your design to PDB
foldseek easy-search design.pdb pdb100 similar_natural.m8 tmp/
```

### Novelty check
```bash
# Ensure design is novel (low similarity to known)
foldseek easy-search design.pdb afdb50 novelty.m8 tmp/

# Novel if: top hit identity < 30%
```

### Scaffold search
```bash
# Find scaffolds for motif grafting
foldseek easy-search motif.pdb pdb100 scaffolds.m8 tmp/ \
  --min-seq-id 0.0 -e 10
```

---

## Verify

```bash
wc -l results.m8  # Number of hits
```

---

## Troubleshooting

**No hits**: Lower e-value threshold, try larger database
**Too many hits**: Increase min-seq-id threshold
**Slow search**: Use smaller database

### Error interpretation

| Error | Cause | Fix |
|-------|-------|-----|
| `Database not found` | Wrong path | Check database location |
| `Invalid PDB` | Malformed structure | Validate PDB format |
| `Out of memory` | Large database | Use more RAM or web server |

---

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

Versions

RepositoryScoreLicence
This page · FreedomIntelligence/OpenClaw-Medical-Skills100MIT
adaptyvbio/protein-design-skills95MIT

Database snapshot: 13.11.2026 · package version 11d9220c5b91 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 95protein_similarity_search
    Protein Similarity Search - Search for similar proteins: extract sequence from PDB, search structures with FoldSeek, find homologs with STRING, and check UniProt. Use this skill for bioinformatics tasks involving extract pdb sequence foldseek search get best similarity hits…
  • 95protein_similarity_search
    Protein Similarity Search - Search for similar proteins: extract sequence from PDB, search structures with FoldSeek, find homologs with STRING, and check UniProt. Use this skill for bioinformatics tasks involving extract pdb sequence foldseek search get best similarity hits…
  • 85foldseek-structural-search
    Performs 3D structural searches of proteins against various databases (PDB, AlphaFold, CATH, MGnify, etc.) using the Foldseek API. Use ONLY when the user provides a physical 3D coordinate file (.cif, .mmcif, or .pdb) and wants to find structurally similar proteins. Do NOT use if…
  • 95bio-remote-homology
    Detect distant homologs using profile and structure-aware methods that go beyond standard BLAST. Use when sequence identity falls into the twilight zone (<35% pairwise), when BLAST fails to find homologs that should exist, when working at metagenomic scale (DIAMOND, MMseqs2), or…
  • 90foldseek-structural-search
    Performs 3D structural searches of proteins against various databases (PDB, AlphaFold, CATH, MGnify, etc.) using the Foldseek API. Use ONLY when the user provides a physical 3D coordinate file (.cif, .mmcif, or .pdb) and wants to find structurally similar proteins. Do NOT use if…
  • 85foldseek-structural-search
    Performs 3D structural searches of proteins against various databases (PDB, AlphaFold, CATH, MGnify, etc.) using the Foldseek API. Use ONLY when the user provides a physical 3D coordinate file (.cif, .mmcif, or .pdb) and wants to find structurally similar proteins. Do NOT use if…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.