tooluniverse-protein-structure-retrieval
Protein structure retrieval from RCSB PDB, PDBe, and AlphaFold with disambiguation, quality assessment (resolution, R-factor, pLDDT), and metadata. Distinguishes high-quality experimental (X-ray under 2 Angstrom) vs predicted vs medium-quality structures. Use for fetching protein structures, structu
By mims-harvard · 419 installs
npx skills add mims-harvard/tooluniverse --skill tooluniverse-protein-structure-retrieval
Source repository · Upstream listing
Protein Structure Data Retrieval
Retrieve protein structures with disambiguation, quality assessment, and comprehensive metadata.
IMPORTANT : Always use English terms in tool calls. Respond in the user's language.
LOOK UP DON'T GUESS : Never assume PDB IDs, resolution, or availability. Always query RCSB/PDBe and AlphaFold to confirm.
Domain Reasoning
Not all structures are equal. X ray <2 A is high quality for drug design. Cryo EM 3 4 A is good for fold but not side chains. AlphaFold is excellent for well folded domains but unreliable for disordered regions. Always check pLDDT (AlphaFold) or resolution (experimental) before drawing conclusions.
Workflow
Phase 0: Clarification (When Needed)
Ask ONLY if: protein name ambiguous (e.g., "kinase"), organism not specified, unclear if experimental vs AlphaFold needed.
Skip for: specific PDB IDs, UniProt accessions, unambiguous protein+organism.
Phase 1: Protein Disambiguation
Identity Checklist
Protein name/gene identified, organism confirmed
UniProt accession (if available), isoform/variant specified (if relevant)
Phase 2: Data Retrieval (Internal)
Retrieve silently. Do NOT narrate the process.
Fallback Chains
Primary Fallback
RCSB search PDBe search
get protein metadata pdbe get entry summary
Experimental structure AlphaFold prediction
get protein ligands PDBe KB get ligand sites
Phase 3: Report Structure Profile
Present as a Structure Profile Report . Hide search process. Include:
1. Search Summary : query, organism, experimental + AlphaFold structure counts
2. Best Structure : PDB ID, UniProt, organism, method, resolution, date, quality assessment
3. Experimental Details : method, resolution, R factor, R free, space group
4. Composition : chains, residues (coverage%), ligands, waters, metals
5. Bound Ligands : ligand ID, name, type, binding site
6. Binding Site Details (for drug discovery): location, key residues, druggability
7. Alternative Structures : ranked by quality with resolution, method, ligands
8. AlphaFold Prediction : UniProt, model version, pLDDT confidence distribution, use cases
9. Structure Comparison : resolution, completeness, ligands across structures
10. Download Links : PDB/mmCIF/AlphaFold formats, database URLs
Quality Assessment
Experimental Structures
Tier Criteria
Excellent X ray <1.5A, complete, R free <0.22
High X ray <2.0A OR Cryo EM <3.0A
Good X ray 2.0 3.0A OR Cryo EM 3.0 4.0A
Moderate X ray 3.0A OR NMR ensemble
Low 4.0A, incomplete, or problematic
Resolution Use Cases
<1.5A: atomic detail, H bond analysis. 1.5 2.0A: drug design. 2.0 2.5A: structure based design. 2.5 3.5A: overall architecture. 3.5A: domain arrangement only.
AlphaFold Confidence (pLDDT)
90: very high, experimental like. 70 90: good backbone. 50 70: uncertain/flexible. <50: likely disordered.
Error Handling
Error Response
"PDB ID not found" Verify 4 char format, check if obsoleted
"No structures" Offer AlphaFold, suggest similar proteins
"Download failed" Retry once, provide alternative link
"Resolution unavailable" Likely NMR/model, note in assessment
Tool Reference
RCSB PDB : PDBeSearch search structures (search), get protein metadata by pdb id (basic info), RCSBData get entry (details), PDBeValidation get quality scores (quality), PDBe KB get ligand sites (ligands), PDBeSIFTS get all structures (homologs)
PDBe : pdbe get entry summary (overview), pdbe get entry molecules (entities), pdbe get entry experiment (experimental), PDBe KB get ligand sites (pockets)
AlphaFold : alphafold get prediction (get prediction), alphafold get summary (search)