BioClaw structural-biology

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

install
source · Clone the upstream repo
git clone https://github.com/Runchuan-BU/BioClaw
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/Runchuan-BU/BioClaw "$T" && mkdir -p ~/.claude/skills && cp -r "$T/container/skills/structural-biology" ~/.claude/skills/runchuan-bu-bioclaw-structural-biology && rm -rf "$T"
manifest: container/skills/structural-biology/SKILL.md
source content

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

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

pLDDTInterpretation
> 90
very high confidence
70-90
good backbone confidence
50-70
low confidence
< 50
likely disorder or unreliable local structure

PAE

PAEInterpretation
< 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

Related Skills

  • Proteomics
  • Pathway Analysis

Optional Supplements

  • alphafold-database