protein-sequence-similarity-search

Searches protein sequence homologues using MMseqs2 or EBI BLAST APIs.

Updated Jan 8, 2026
One-click install
npx skills add https://github.com/arslan9024/White-Caves --skill protein-sequence-similarity-search-arslan9024
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: protein-sequence-similarity-search
Source: https://github.com/arslan9024/White-Caves/tree/main/.agents/skills/protein_sequence_similarity_search
Command: npx skills add https://github.com/arslan9024/White-Caves --skill protein-sequence-similarity-search-arslan9024

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires polite-http, python-dotenv, and includes scripts (resource) components.

What problem does it solve? Finding homologous protein sequences and inferring protein function from sequence similarity normally requires manual interaction with BLAST or MMseqs2 web portals, result parsing, and metric interpretation. This Skill automates the entire workflow from a raw amino acid sequence or FASTA file to a summarized Markdown report of top homologues. ## Core Features & Use Cases - Dual search methods: Runs fast MMseqs2 searches via the ColabFold API by default, with automatic fallback to comprehensive EBI BLAST when MMseqs2 fails or when BLAST is explicitly requested. - Validated database selection: Supports 25 curated UniProt, UniRef, and PDB database codes with strict validation against an allowed list. - Structured output: Generates Markdown tables of top hits with Q-Cov, E-value, sequence identity, and alignment length, plus JSON files for downstream programmatic analysis. - Use Case: A researcher has an uncharacterized protein sequence and wants to infer its function. The Skill searches for homologues, interprets alignment metrics, and summarizes the functions of the top 3-5 hits. ## Quick Start Find homologues for the protein sequence in my file query.fasta and summarize the likely function of the protein.

Frequently Asked Questions about protein-sequence-similarity-search

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

FAQPage Schema
How do I find homologues for a protein sequence?▼

Provide a raw amino acid sequence or a FASTA file path, and the Skill runs an MMseqs2 search via the ColabFold API by default. Results are returned as a Markdown table of top hits sorted by E-value, with an optional JSON export.

What is the difference between MMseqs2 and BLAST for protein search?▼

MMseqs2 via the ColabFold API is the fast default, typically finishing in under two minutes. EBI BLAST is slower, up to 15 minutes, but supports explicit database selection across 25 UniProt, UniRef, and PDB databases and serves as the fallback when MMseqs2 fails.

Which BLAST databases can I search against UniProt sequences?▼

The Skill validates against 25 allowed codes including uniprotkb, uniprotkb_swissprot, uniprotkb_bacteria, uniprotkb_human, uniref90, uniref50, and pdb. Requesting a database outside this list stops the search and returns the allowed list.

What happens if the MMseqs2 search fails or hits a rate limit?▼

When the MMseqs2 script exits with code 2 due to rate limiting or API errors, the Skill automatically falls back to the EBI BLAST method and notifies the user of the switch. No results are fabricated if both methods return no hits.

Can this Skill infer protein function from structural similarity?▼

No, it only infers function from sequence similarity. For structure-based function inference, a different structural comparison approach is required, as stated in the Skill's own trigger conditions.