foldseek-structural-search

Search protein 3D structures against Foldseek databases and write Markdown and JSON results.

2.7k|283|Updated May 13, 2026
One-click install
npx skills add https://github.com/google-deepmind/science-skills --skill foldseek-structural-search
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: foldseek-structural-search
Source: https://github.com/google-deepmind/science-skills/tree/main/skills/foldseek_structural_search
Command: npx skills add https://github.com/google-deepmind/science-skills --skill foldseek-structural-search

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires science-skillscommon, uv, and includes scripts (resource) components.

What problem does it solve?

It helps users identify structurally similar proteins by searching a provided 3D protein coordinate file against Foldseek databases, avoiding unreliable or impossible sequence-only searches.

Core Features & Use Cases

  • 3D-only structural homology search: Accepts only physical structure files with .cif, .mmcif, or .pdb extensions and halts if the input is sequence or ID-based.
  • Validated database querying: Searches only an allowlisted set of Foldseek databases (e.g., afdb50, pdb100, cath50) and stops for unsupported database requests.
  • Actionable results for interpretation: Produces a human-readable Markdown table for quick review plus a full JSON output for deeper follow-up analysis.

Quick Start

Use the foldseek-structural-search skill to submit your .pdb/.cif/.mmcif structure file and return the top structural matches with key alignment metrics in a Markdown results file.

Frequently Asked Questions about foldseek-structural-search

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

FAQPage Schema
How do I search for protein structural homologs using a PDB file?

To perform a protein structural homology search, you submit a physical 3D coordinate file with a .pdb, .cif, or .mmcif extension. The tool queries validated Foldseek databases and returns a Markdown summary with top structural matches.

Can I find distant homologous proteins using sequence-only search?

You cannot find distant homologous proteins using sequence-only search because this tool requires physical 3D structure files. It specifically halts if the input is sequence or ID-based, enforcing strict validation for structural alignment tasks.

What Foldseek databases are available for 3D structural alignment?

Available Foldseek databases for 3D structural alignment include afdb50, pdb100, and cath50. The tool enforces an allowed database list and stops execution if you request an unsupported database for your structural similarity search.

What format are the structural search results written in?

Structural search results are written as both a human-readable Markdown table for quick review and a full JSON payload for deeper analysis. These outputs are written directly to disk after querying the Foldseek API using 3diaa mode metrics.

Does the Foldseek API search support MMCIF coordinate files?

The Foldseek API search supports MMCIF coordinate files, accepting .mmcif, .cif, and .pdb extensions. It applies strict input validation to ensure only physical 3D coordinate files are submitted for structural similarity matching.

Why did my structural homology search fail to start?

Your structural homology search fails to start if the input file is sequence or ID-based instead of a validated .pdb, .cif, or .mmcif coordinate file, or if you request a database outside the allowed list.