К основному содержанию
скилл CX Codex

tooluniverse-protein-structural-annotation-pdb — скилл для Claude Code

Скилл tooluniverse-protein-structural-annotation-pdb размечает аминокислотные остатки в структуре PDB по положению в интерфейсе, кармане лиганда или гидрофобном ядре.

Apache-2.0 145 установок ★ 1 798 обновлён 2026-10-24

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add mims-harvard/ToolUniverse --skill tooluniverse-protein-structural-annotation-pdb -a claude-code
Открыть на GitHub

Что делает tooluniverse-protein-structural-annotation-pdb

Скилл формирует таблицу по остаткам для выбранной цепи белка из файла PDB. Для каждой позиции он определяет класс окружения: контакт с партнерской цепью (interface), близость к лиганду (ligand), обе роли сразу (both) или фоновое окружение (other). Дополнительно рассчитывается относительная доступность растворителю (RSA), по которой остаток помечается как погруженный в ядро (is_core) при значении ниже порога 0.25.

Внутрь заложен пайплайн из нескольких шагов: поиск структуры через PDBe SIFTS или RCSB, вызов функции разметки Structure_annotate_per_residue, сверка нумерации с эталоном UniProt и опциональная подгрузка вторичной структуры через PDBe REST. По умолчанию дистанционный порог контактов равен 5.0 Å, но его можно переопределить. Вместо идентификатора pdb_id разрешено передавать локальный контент через pdb_content.

Учтите ограничение: кристаллографическая нумерация часто содержит невидимый сдвиг из-за меток клонирования, поэтому перед объединением данных требуется ручная сверка с референсным остатком.

Какие задачи решает

  • Разметить позиции аминокислот для дорожки под тепловой картой DMS
  • Проверить расположение мутации в интерфейсе комплекса, кармане или гидрофобном ядре
  • Сопоставить дропы признаков разреженных автоэнкодеров (SAE) с физическим окружением белка
  • Рассчитать доступность растворителю (RSA) для выявления скрытых остатков

Примеры запросов агенту

  • Аннотируй структуру 6VJJ для цепи A с партнером B и лигандом GNP
  • Найди лучший PDB для UniProt P01116 через PDBe SIFTS и разметь интерфейсы
  • Проверь по PDB-файлу, попадает ли остаток 12 в карман связывания

Как установить tooluniverse-protein-structural-annotation-pdb

1Через Skills CLI (Vercel)

npx skills add mims-harvard/ToolUniverse --skill tooluniverse-protein-structural-annotation-pdb -a claude-code

2Вручную: положить файлы

~/.claude/skills/tooluniverse-protein-structural-annotation-pdb/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/tooluniverse-protein-structural-annotation-pdb/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о tooluniverse-protein-structural-annotation-pdb

Как установить tooluniverse-protein-structural-annotation-pdb в Claude Code?

Выполните в терминале команду npx skills add mims-harvard/ToolUniverse --skill tooluniverse-protein-structural-annotation-pdb -a claude-code.

Что делает этот скилл?

Он классифицирует каждый остаток полипептидной цепи по расстоянию до лигандов и партнерских цепей, а также вычисляет RSA для разделения поверхностных и коровых позиций.

Подходит ли скилл для поиска скрытых карманов без известного лиганда?

Нет, он работает только с известными гетероатомами из структуры; для слепого поиска карманов авторы рекомендуют докинг вроде SwissDock или базу карманов PDBe.

Исходный текст

SKILL.md · Apache-2.0
---
name: tooluniverse-protein-structural-annotation-pdb
description: "Given a PDB structure, produce a per-residue annotation table: which residues sit at a binding interface (vs a partner chain), which line a ligand pocket, which are buried (core) vs solvent-exposed (surface), and optionally secondary structure. This is the structural track drawn under a DMS heatmap and the structural prior SAE feature drops are read against. Use when you need to anchor a variant-interpretation or DMS analysis to the protein's actual physical context."
disable-model-invocation: true
---

# Protein structural annotation from a PDB

For each residue of a target protein chain, classify whether it sits at a
binding interface, in a ligand pocket, is buried vs solvent-exposed, and
(optionally) which secondary-structure element it belongs to. This is the
annotation track that anchors any DMS heatmap or per-residue interpretation
to the protein's actual physical context.

---

## When to use this skill

- Building a per-residue annotation track for a DMS heatmap
- Deciding whether a variant of interest is **in an interface, in a pocket, or
  in the core** — context that often distinguishes plausible mechanisms
- Reading SAE feature drops at a position against the protein's known biology
  (a feature drop at a ligand-pocket residue means something different from a
  drop at a surface residue)

**Not for**:
- Multi-conformer ensembles or NMR structure comparisons → use
  `tooluniverse-computational-biophysics`
- Whole-structure pocket detection without a known ligand → use a docking
  tool (e.g. SwissDock) or PDBe's pre-computed pockets

---

## Required inputs

| Input | Format | Example |
|---|---|---|
| PDB ID | 4 characters | `6VJJ` (KRAS-RAF1-GTP analogue) |
| Target chain | single character | `A` |
| Partner chain(s) | list of chain IDs | `["B"]` |
| Ligand resnames | 3-letter PDB names | `["GNP", "MG"]` |

Optional:
- `distance_cutoff` (default 5.0 Å)
- `core_rsa_cutoff` (default 0.25)
- `include_secondary_structure` (default false; uses PDBe REST if true)
- `pdb_content` instead of `pdb_id` for local / predicted structures

---

## Workflow

### Step 1 (optional): Find the relevant PDB

If you only have a UniProt accession or gene symbol, pick a structure first:

```python
# PDBe's curated UniProt→PDB mapping (recommended; ranks by coverage + resolution)
PDBeSIFTS_get_best_structures(uniprot_accession="P01116")
# Returns a ranked list of PDB IDs for KRAS with chain mapping

# Or full list (unranked)
PDBeSIFTS_get_all_structures(uniprot_accession="P01116")

# RCSB advanced search (free-text, when you don't have a UniProt yet)
RCSBAdvSearch_search_structures(query="KRAS GTP complex")
```

Pick the structure that contains the **right complex**: include the binding
partner chain you care about, the relevant ligand, and a resolution adequate
for distance-based classification (≤ 3 Å is a safe default).

### Step 2: Run the annotation

```python
Structure_annotate_per_residue(
    pdb_id="6VJJ",
    target_chain="A",
    partner_chains=["B"],
    ligand_resnames=["GNP", "MG"],
    distance_cutoff=5.0,
    core_rsa_cutoff=0.25,
    include_secondary_structure=False,
)
```

Returns `annotations: List[{position, aa, dist_partner, dist_ligand, rsa,
region, is_core, ss_element?}]` for every residue of the target chain. For
KRAS in 6VJJ, this yields 168 rows.

### Step 3: Verify the numbering before joining

PDB residue numbers carry **silent offsets** — crystal constructs add
N-terminal cloning residues, and published figures sometimes shift the track
relative to the panel sequence. Always verify with a landmark:

```python
# Get the canonical reference sequence
UniProt_get_sequence_by_accession(accession="P01116")
# Then spot-check: KRAS canonical position 12 should be glycine
assert annotations[11]["aa"] == "G"  # 1-indexed position 12, 0-indexed index 11
```

If the landmark mismatches, record the offset explicitly (e.g. `pdb_pos =
uniprot_pos + offset`) before any downstream join. **Do not silently rebase
positions.**

### Step 4: Combine with secondary structure (optional)

If you set `include_secondary_structure=True`, the tool fetches per-residue
helix/strand/coil from PDBe REST. Alternatively, use the dedicated PDBe
secondary-structure tool separately:

```python
pdbe_get_entry_secondary_structure(pdb_id="6VJJ")
# Returns per-chain helix + strand ranges
```

### Step 5: Use the annotation

The returned table is keyed by 1-based canonical residue number. Typical
downstream uses:

| Use case | Field to read |
|---|---|
| Is variant X in a pocket? | `by_pos = {a["position"]: a for a in annotations}; by_pos[X]["region"] in ("ligand", "both")` — index by position field, NOT list index (PDB residue numbers may not start at 1 or be contiguous) |
| Build a DMS heatmap annotation track | `[(r["position"], r["region"], r["is_core"], r.get("ss_element"))]` |
| Filter SAE hotspot features to ligand-binding residues | filter clusters by `region == "ligand"` |
| Compare buried vs surface signal | group statistics by `is_core` |

---

## Interpretation table

| Region label | Biological meaning | Common functional role |
|---|---|---|
| `interface` | Within `distance_cutoff` of a partner chain | Protein-protein binding residue; variants often disrupt complex formation |
| `ligand` | Within `distance_cutoff` of a ligand heavy atom | Pocket residue; variants often disrupt substrate / cofactor / drug binding |
| `both` | Both | Allosteric or shared-surface residue |
| `other` | Neither | Surface (if not `is_core`) or core (if `is_core`) — variants impact through stability or distal effects |
| `is_core=true` | RSA < `core_rsa_cutoff` (0.25 by default) | Buried residue; variants often destabilize the fold |

---

## Honest limitations

1. **One conformer only**. A static crystal structure does not capture
   alternative conformations or induced-fit binding. A residue may be at the
   pocket in one conformer and away in another. Pick the structure whose
   bound state matches your question.
2. **Numbering is fragile**. Crystal constructs add N-terminal tags or skip
   disordered N/C termini. **Always verify** with a landmark before joining
   to a sequence or to another annotation source. The skill cannot detect
   silent offsets for you.
3. **Distance cutoff is a convention, not a truth**. 5.0 Å is the literature
   default. Tighten to 4.0 Å for stricter pocket
   calls; loosen to 6.0 Å to include 2nd-shell residues.
4. **freesasa RSA can exceed 1.0** for small / unusual structures because the
   max-ASA reference is calibrated for a typical protein context. For real
   well-folded proteins values cluster in [0, 1.2]; reading them as a
   fraction is fine, but treat extreme values as a flag to inspect.
5. **`partner_chains=[]` is permitted** but then all `dist_partner` values
   are `null` — interface analysis is skipped entirely.
6. **HETATM ligands only**. Modified residues (e.g. phosphoresidues already
   in the chain) are not detected as ligands — they are part of the chain.

---

## Cross-references

| Tool | Role | Use it for |
|---|---|---|
| `Structure_annotate_per_residue` | This skill's atomic tool | The annotation itself |
| `PDBeSIFTS_get_best_structures` | UniProt → ranked PDB list | Step 1 |
| `PDBeSIFTS_get_all_structures` | UniProt → full PDB list | Step 1 |
| `RCSBAdvSearch_search_structures` | Free-text RCSB search | Step 1 |
| `UniProt_get_sequence_by_accession` | Canonical sequence | Step 3 (numbering verification) |
| `pdbe_get_entry_secondary_structure` | SS alone | Step 4 alternative |
| `tooluniverse-residue-functional-mechanism-interpretation` | Downstream consumer | Use this annotation as the structural evidence layer when interpreting DMS hotspots; the skill also plots an annotated DMS heatmap in its Step 7 |

© mims-harvard · Apache-2.0 · mims-harvard/ToolUniverse

Похожие скиллы

Все скиллы по теме «Наука и исследования» →
protein-mcp-server cyanheads MCP-сервер protein-mcp-server подключает поиск, скачивание и анализ экспериментальных и предсказанных белковых структур из PDB, AlphaFold DB и UniProt без API-ключей. CX Codex +1 ★ 6звёзд репо protein-sequence-similarity-search google-deepmind Скилл protein-sequence-similarity-search ищет гомологичные последовательности белка через MMseqs2 или BLAST, разбирает метрики выравнивания и сохраняет таблицу хитов в Markdown. CX Codex +1 2 400установок RCSB PDB rcsb Сервер RCSB PDB связывает ИИ-агента с базой Protein Data Bank для поиска трёхмерных структур белков, сопоставления последовательностей и чтения аннотаций. CX Codex +1 ★ 12звёзд репо protein-interactions ssinder Скилл protein-interactions для Claude Code разбирает отчёты PLIP и архивы AlphaFold, извлекая взаимодействия белков на уровне остатков. Включается при анализе контактов, поиске горячих точек и визуализации. CX Codex +1 ★ 77звёзд репо protein-sequence-msa google-deepmind Скилл protein-sequence-msa для Claude Code, Codex, Cursor и других платформ, который выравнивает несколько белковых последовательностей через API EBI Clustal Omega. CX Codex +1 2 400установок protein-docking-lightdock ssinder Скилл protein-docking-lightdock для Claude Code запускает локальный белковый докинг через LightDock и выгружает модели комплексов в PDB. Обрабатывает сетки рецептор-лиганд и ведёт ранжирование по DFIRE. CX Codex +1 ★ 77звёзд репо

Из того же набора136

Весь набор →
tooluniverse-population-genetics Скилл tooluniverse-population-genetics для анализа генетического разнообразия: частоты аллелей в популяциях (gnomAD, 1000 Genomes), тестирование равновесия Харди-Вайнберга, эволюционные ограничения. CX Codex +1 150установок tooluniverse-gene-regulatory-networks Скилл tooluniverse-gene-regulatory-networks координирует поиск регуляторных сетей генов: находит мотивы связывания в JASPAR, мишени ChIP-seq через Enrichr, eQTL в GTEx и взаимодействия в STRING. CX Codex +1 148установок devtu-benchmark-harness Скилл devtu-benchmark-harness для Claude Code и Codex запускает пятишаговый цикл тестирования инструментов ToolUniverse: прогон бенчмарка, анализ ошибок, диагностика, маршрутизация исправлений, повторный тест. CX Codex +1 148установок tooluniverse-meta-analysis Скилл tooluniverse-meta-analysis для Claude Code объединяет результаты нескольких исследований, оценивает неоднородность и строит лесной график. Выполняет мета-анализ для систематических обзоров и повторённых экспериментов. CX Codex +1 146установок tooluniverse-variant-predictor-dms-validation Скилл tooluniverse-variant-predictor-dms-validation сверяет оценки влияния мутаций белков с экспериментальными данными глубокого мутационного сканирования (DMS). Помогает понять, отражает ли модель реальный эффект на функцию. CX Codex +1 142установок tooluniverse-protein-lof-mechanism Скилл tooluniverse-protein-lof-mechanism синтезирует пять слоёв вычислительных данных — от AlphaMissense до DynaMut2 — чтобы предложить конкретный механизм, как миссенс-вариант приводит к потере функции белка. CX Codex +1 141установок tooluniverse-pharmacokinetics Скилл tooluniverse-pharmacokinetics для Claude Code рассчитывает фармакокинетические параметры по концентрациям препарата во времени. Анализирует профиль после дозы и биодоступность при IV- и пероральном введении. CX Codex +1 140установок tooluniverse-protein-sae-variant-interpretation Скилл tooluniverse-protein-sae-variant-interpretation объясняет механизм мутаций белка через разреженные автоэнкодеры ESMC-6B, показывая потерю или появление биологических признаков. CX Codex +1 140установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой