mcpbeat

Structural Biology

biotender-max/structural-biology

Structure retrieval, confidence-aware AlphaFold DB usage, coordinate download, PAE and pLDDT interpretation, and structure-guided biological annotation.

2k tokens
context cost
the whole folder, loaded on every use
3
files
instructions only
0
copies elsewhere
how many repositories repackaged it
132
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository
npx skills add https://github.com/BioTender-max/awesome-bio-agent-skills --skill structural-biology

What comes with it

2 006 bytes besides the instruction
commands_and_thresholds.md
technical_reference.md

The instruction itself

23 sections, as written by the author

Structural Biology

Version Compatibility

Reference examples assume:

  • biopython 1.84+
  • AlphaFold DB public API current format
  • optional visualization stack such as py3Dmol or PyMOL

Verify before use:

  • Python: python -c "import Bio; print(Bio.__version__)"

Overview

Use this skill when the task is:

  • retrieving AlphaFold-predicted structures by UniProt accession
  • downloading coordinate and confidence files
  • reading pLDDT or PAE to judge confidence
  • mapping sequence findings onto structure

When To Use This Skill

  • a UniProt accession or known protein target exists
  • experimental structure is absent or incomplete
  • the user needs confidence-aware structural interpretation

Quick Route

  • known UniProt accession: query AlphaFold DB first
  • novel designed sequence without AlphaFold DB entry: use a separate prediction workflow such as ColabFold
  • structure interpretation request: always inspect pLDDT and PAE before making mechanistic claims

Progressive Disclosure

  • Read technical_reference.md for confidence interpretation and source-selection rules.
  • Read commands_and_thresholds.md for AlphaFold DB retrieval patterns, URL layouts, and file conventions.

Expected Inputs

  • UniProt accession or sequence context
  • optional residue list, mutation list, or ligand site hypothesis

Expected Outputs

  • results/structures/AF-<accession>.cif
  • results/structures/AF-<accession>.pdb
  • results/confidence/AF-<accession>-confidence.json
  • results/confidence/AF-<accession>-pae.json
  • figures/AF-<accession>-pae.png

Starter Pattern

from Bio.PDB import alphafold_db

prediction = next(alphafold_db.get_predictions("P00520"))
cif_path = alphafold_db.download_cif_for(prediction, directory="results/structures")
print(cif_path)

Confidence Thresholds

pLDDT

| pLDDT | Interpretation |

|---|---|

| > 90 | very high confidence |

| 70-90 | good backbone confidence |

| 50-70 | low confidence |

| < 50 | likely disorder or unreliable local structure |

PAE

| PAE | Interpretation |

|---|---|

| < 5 Å | confident relative positioning |

| 5-15 Å | moderate uncertainty |

| > 15 Å | domain orientation may be unreliable |

Workflow

1. Choose the structure source

  • experimental structure if available and suitable
  • AlphaFold DB for known proteins with UniProt accessions
  • separate prediction workflow for novel sequences

2. Retrieve coordinates and confidence files

Download:

  • mmCIF or PDB
  • confidence JSON
  • PAE JSON

3. Inspect confidence before interpretation

Do not map mutations or infer interfaces from low-confidence regions without saying so.

4. Annotate the biological question

Map domains, active sites, mutations, motifs, or interfaces onto the structure.

5. Export reusable artifacts

Save coordinates, confidence files, and a PAE heatmap or equivalent summary.

Output Artifacts

results/
├── structures/
│   ├── AF-P00520-F1-model_v4.cif
│   └── AF-P00520-F1-model_v4.pdb
└── confidence/
    ├── AF-P00520-F1-confidence_v4.json
    └── AF-P00520-F1-predicted_aligned_error_v4.json
figures/
└── AF-P00520-F1-pae.png

Quality Review

  • pLDDT must be reviewed before claiming local residue geometry is trustworthy
  • PAE must be reviewed before claiming domain-domain arrangement is trustworthy
  • residue numbering and chain mapping must be checked before mutation interpretation
  • low-confidence or disordered regions should be labeled explicitly

Anti-Patterns

  • treating every AlphaFold region as equally reliable
  • ignoring PAE when discussing domain orientation
  • mapping variants onto mismatched residue numbering
  • using AlphaFold DB retrieval as if it were de novo prediction for novel sequences
  • Proteomics
  • Pathway Analysis

Optional Supplements

  • alphafold-database

How to use it

Copy the folder

Take biotender-max/structural-biology from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.