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

protein-structure — скилл для Claude Code: анализ PDB

Скилл protein-structure для Claude Code анализирует белковые структуры из PDB-файлов. Он включается при запросах о вторичной структуре, радиусе инерции или разборе PDB.

MIT ★ 77 обновлён 2026-10-27

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add ssinder/bioinformatics-agent-skills --skill protein-structure -a claude-code
Открыть на GitHub

Что делает protein-structure

protein-structure разбирает записи ATOM и HETATM, считает радиус инерции, тензор инерции и дипольный момент, а также определяет вторичную структуру. Для этого есть встроенный парсер на чистом Python и встроенная реализация метода Kabsch—Sander; вместо неё можно вызвать DSSP через mkdssp. Результаты сохраняются в structure_analysis.json и structure_analysis.csv.

Скилл обрабатывает отдельные PDB-файлы и каталоги, а по запросу добавляет сведения о белке из UniProt. Для работы нужен Python 3.9 или новее. Biopython, mkdssp и requests перечислены как необязательные зависимости; запрос к UniProt требует доступа к сети.

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

  • разобрать PDB-файл без Biopython
  • вычислить радиус инерции и параметры формы белка
  • назначить вторичную структуру через встроенный метод или DSSP
  • собрать статистику по каталогу PDB-файлов
  • добавить к результатам сведения из UniProt

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

  • Проанализируй структуру из 1crn.pdb и сохрани отчёты в results/.
  • Посчитай статистику по PDB-файлам в ./pdb_data и сохрани сводку в results/.
  • Добавь к анализу структуры сведения из UniProt.

Как установить protein-structure

1Через Skills CLI (Vercel)

npx skills add ssinder/bioinformatics-agent-skills --skill protein-structure -a claude-code

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

~/.claude/skills/protein-structure/SKILL.md

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

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

Вопросы о protein-structure

Как установить protein-structure в Claude Code?

Выполни npx skills add ssinder/bioinformatics-agent-skills --skill protein-structure -a claude-code. Файл скилла находится по пути ~/.claude/skills/protein-structure/SKILL.md.

Что делает protein-structure?

Разбирает PDB-файлы, вычисляет геометрические характеристики белка и назначает вторичную структуру. Также умеет обрабатывать каталоги и запрашивать аннотации UniProt.

Что нужно для работы protein-structure?

Нужен Python 3.9 или новее. Biopython, DSSP (mkdssp) и requests указаны как необязательные зависимости; для запроса сведений UniProt нужен доступ к сети.

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

SKILL.md · MIT
---
name: protein-structure
description: >-
  Analyzes protein structures from PDB files: parses ATOM/HETATM records with a
  dependency-free pure-Python parser, computes radius of gyration, gyration tensor
  and dipole moments, assigns secondary structure via DSSP or a built-in
  Kabsch-Sander hydrogen-bond implementation, and optionally retrieves UniProt
  metadata. This skill should be used when secondary structure assignment, Rg,
  shape analysis, DSSP, PDB parsing or protein structure annotation is requested.
license: MIT
compatibility: Python 3.9+; optional Biopython, DSSP (mkdssp), requests
metadata:
  version: "1.0"
  last-reviewed: "2026-10-25"
  skill-author: sinder
---

# Protein Structure Analysis

## Overview

This skill turns raw PDB coordinates into quantitative structural descriptors without
requiring heavyweight dependencies. It ships a self-contained PDB parser that handles
`ATOM` / `HETATM` records, multi-model files, alternate locations and insertion codes,
plus a built-in secondary-structure assigner based on the Kabsch-Sander hydrogen-bond
energy model. Geometry (radius of gyration, gyration tensor principal axes, shape
descriptors, dipole moment) is computed in pure Python, and UniProt metadata can be
attached on request.

## When to Use This Skill

- Secondary structure assignment of a protein (`DSSP`, `H`/`E`/`C` content, helix percentage)
- Radius of gyration, radius of gyration tensor, shape anisotropy of a folded protein
- Parsing PDB files without installing Biopython
- Batch statistics over a directory of PDB files (length distribution, average Rg)
- Attaching UniProt protein names, organism and function to structural results
- Preliminary characterisation of AlphaFold models or predicted structures

## Quick Start

```bash
# 单个结构:解析 + 几何 + 二级结构
python scripts/analyze_structure.py --input 1crn.pdb --output results/

# 强制使用内置 DSSP 实现(系统未装 mkdssp 时)
python scripts/analyze_structure.py --input 1crn.pdb --output results/ --dssp-method builtin

# 批量处理整个目录(4 线程)
python scripts/batch_analyze.py --input ./pdb_data --output results/ --workers 4

# 附加 UniProt 元数据(需要网络)
python scripts/analyze_structure.py --input P69905.pdb --output results/ --query-uniprot
```

## Workflow

1. **Parse** — `pdb_parser.py` reads fixed-column PDB records into a
   `Structure → Model → Chain → Residue → Atom` tree. Alternate locations keep only
   the primary conformer (`' '`, `'A'`, `'1'`); `MODEL`/`ENDMDL` splits multi-model files.
2. **Summarise** — chain/residue/atom counts, element composition, heteroatom inventory,
   per-chain one-letter sequences.
3. **Geometry** — `geometry.py` computes mass-weighted `Rg` (and `Rg` over Cα only),
   the gyration tensor with a Jacobi eigen-decomposition, shape descriptors
   (asphericity, acylindricity, relative shape anisotropy) and a partial-charge
   dipole estimate.
4. **Secondary structure** — `secondary_structure.py` either shells out to `mkdssp`
   or runs the built-in assigner: rebuild missing amide hydrogens, evaluate
   Kabsch-Sander hydrogen-bond energies, and classify `H`/`G`/`I`/`E`/`B`/`T`/`S`/`-`.
5. **Annotate** — optionally query `rest.uniprot.org` for protein name, organism,
   sequence length and function via the shared `http_session` (retry + rate limit).
6. **Report** — write `structure_analysis.json` and `structure_analysis.csv`.

## Parameters

| Parameter | Script | Default | Description |
|---|---|---|---|
| `--input` | both | required | PDB file or directory of PDB files |
| `--output` | both | `results/` | Output directory for reports |
| `--dssp-method` | both | `auto` | `auto` / `external` / `builtin` secondary-structure backend |
| `--dssp-executable` | both | auto-detected | Path to `mkdssp` or `dssp` |
| `--hbond-energy` | both | `-0.5` | Hydrogen-bond energy threshold (kcal/mol) for the built-in assigner |
| `--model` | analyze | `1` | Which model to analyse (1-based) |
| `--query-uniprot` | both | off | Enable UniProt metadata lookup (network access) |
| `--format` | analyze | `both` | `json` / `csv` / `both` |
| `--workers` | batch | `4` | Worker threads for batch processing |
| `--pattern` | batch | `*.pdb` | Glob pattern for batch discovery |
| `--recursive` | batch | off | Recurse into subdirectories |
| `--min-residues` | batch | `0` | Skip structures shorter than this |
| `--max-files` | both | `0` | Cap the number of files (0 = unlimited) |

## Outputs

| File | Content |
|---|---|
| `structure_analysis.json` | Full nested report: structure summary, chains, geometry, per-residue secondary structure, UniProt annotation |
| `structure_analysis.csv` | Flat one-row-per-structure table (Rg, shape class, helix/sheet percentages) |
| `batch_summary.json` | Aggregate statistics over a directory plus per-structure detail |
| `batch_results.csv` | Flat table of the batch run |

## Validation

- **Hydrogen-bond geometry**: in a genuine alpha helix the `O(i)···N(i+4)` distance must
  be ~2.9-3.1 Å. The built-in assigner only reports `H` when that contact exists.
- **Backbone sanity**: `Cα(i)-Cα(i+1)` should be ~3.8 Å and `C(i)-N(i+1)` ~1.33 Å.
  Distances far from these indicate a malformed or non-standard PDB.
- **Helix content**: globular proteins typically show 20-50% helix. A reported value near
  0% or 100% for a folded protein is a red flag for the hydrogen-bond threshold.
- **Cross-check**: compare `builtin` against `external` DSSP on the same file
  (`--dssp-method builtin` vs `--dssp-method external`). Agreement within a few
  percent on helix content is expected; large divergence usually means the structure
  lacks resolved hydrogens or is highly non-standard.
- **Rg plausibility**: for a 100-residue globular domain `Rg` is roughly 11-14 Å
  (`Rg ≈ 2.2 × N^0.38` Å is a common empirical rule).
- **Element counts**: hydrogen atoms are usually absent from X-ray structures, so
  `element_counts` containing only C/N/O is expected, not a parse failure.

## References

- `references/methodology.md` — algorithms, formulas and parameter selection rationale
- `references/troubleshooting.md` — common failures and how to diagnose them

© ssinder · MIT · ssinder/bioinformatics-agent-skills

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

Все скиллы по теме «Наука и исследования» →
tooluniverse-protein-structure-retrieval mims-harvard Скилл tooluniverse-protein-structure-retrieval для поиска и оценки качества белковых структур в базах RCSB PDB, PDBe, AlphaFold и SWISS-MODEL. Находит экспериментальные и предсказанные модели для драг-дизайна. CX Codex +1 441установок tooluniverse-protein-structure-prediction mims-harvard Скилл tooluniverse-protein-structure-prediction для Claude Code предсказывает структуру белка по аминокислотной последовательности и собирает данные для оценки. Анализирует новый белок и влияние варианта на структуру. CX Codex +1 245установок protein-sequence-similarity-search google-deepmind Скилл protein-sequence-similarity-search ищет гомологичные последовательности белка через MMseqs2 или BLAST, разбирает метрики выравнивания и сохраняет таблицу хитов в Markdown. CX Codex +1 2 400установок protein-sequence-msa google-deepmind Скилл protein-sequence-msa для Claude Code, Codex, Cursor и других платформ, который выравнивает несколько белковых последовательностей через API EBI Clustal Omega. CX Codex +1 2 400установок boltz-protein-screen официальный Boltz Скилл boltz-protein-screen ранжирует готовые белки, пептиды, антитела и нанободи против заданной мишени через Boltz API. Не подходит для дизайна новых белков и скрининга малых молекул. CX Codex GP ChatGPT +1 ★ 8 052звёзд репо boltz-protein-design официальный Boltz Скилл boltz-protein-design для Codex проектирует через Boltz API связывающие белки, пептиды и антитела под заданную мишень. Генерирует молекулы de novo без ручной разметки скаффолдов. CX Codex GP ChatGPT +1 ★ 8 052звёзд репо

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

Весь набор →
protein-interactions Скилл protein-interactions для Claude Code разбирает отчёты PLIP и архивы AlphaFold, извлекая взаимодействия белков на уровне остатков. Включается при анализе контактов, поиске горячих точек и визуализации. CX Codex +1 ★ 77звёзд репо ml-peptide-generation Скилл ml-peptide-generation для Claude Code генерирует пептиды-кандидаты для связывания с целевым белком. Он ранжирует последовательности по псевдоперплексности и сравнивает настройки длины и top-k. CX Codex +1 ★ 77звёзд репо ena-download Скилл ena-download для Claude Code загружает данные секвенирования FASTQ и метаданные через ENA Portal API. Включается при запросе сырых прочтений по номерам SRA, ERR или DRR. CX Codex +1 ★ 77звёзд репо bioproject-search Скилл bioproject-search для Claude Code выгружает метаданные проектов NCBI BioProject через E-utilities API. Сохраняет названия, организмы и даты релизов в CSV или JSON. CX Codex +1 ★ 77звёзд репо protein-docking-lightdock Скилл protein-docking-lightdock для Claude Code запускает локальный белковый докинг через LightDock и выгружает модели комплексов в PDB. Обрабатывает сетки рецептор-лиганд и ведёт ранжирование по DFIRE. CX Codex +1 ★ 77звёзд репо alphafold-db Скилл alphafold-db для Claude Code скачивает предсказанные структуры белков из AlphaFold DB и собирает метрики pLDDT. Запускается при запросе моделей по UniProt accession или отбора по уверенности. CX Codex +1 ★ 77звёзд репо bio-database-fetch Скилл bio-database-fetch для Claude Code выгружает свойства химических соединений из PubChem и таксономию видов из NCBI. Забирает данные пачками по 100 идентификаторов через официальные REST API. CX Codex +1 ★ 77звёзд репо protein-docking-hdock Скилл protein-docking-hdock для Claude Code отправляет задачи стыковки белков на сервер HDOCK и получает оценки и модели комплексов. Он подключается по запросам на предсказание структуры или загрузку результатов. CX Codex +1 ★ 77звёзд репо

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

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