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

personal-genomics — скилл анализа ДНК

Скилл personal-genomics разбирает сырые файлы ДНК локально: фармакогеномика, риски болезней, носительство, происхождение и признаки. Генетические данные не покидают машину.

Apache-2.0 ★ 173 обновлён 2026-10-24

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

Что делает personal-genomics

Скилл запускает локальный набор скриптов personal-genomics на сырых файлах ДНК и собирает отчёт. Данные никуда не уходят, анализ идёт на машине. Вход: выгрузки 23andMe, AncestryDNA, MyHeritage и FTDNA, а также .vcf или .vcf.gz после секвенирования.

Один файл обрабатывает comprehensive_analysis.py, два и больше — combine_sources.py, который сначала сливает источники. Слияние не формальность: variants-only VCF перечисляет только отличия от референса, гомозиготные участки в нём отсутствуют. Прочитать такой файл в одиночку: находок выйдет меньше, чем из простого массива. Объединение берёт нормальные вызовы массива и редкие варианты VCF. На выходе agent_summary.json, report.txt и dashboard.html; скилл читает сводку, показывает критичные алерты и отдаёт дашборд через SendUserFile.

Скрипты вызываются питоном из ~/git/personal-genomics/.venv; без pandas, numpy, scipy и reportlab в этом окружении запуск не пойдёт, venv ставится из requirements.txt перед первым анализом. Вывод по умолчанию пишется в ~/dna-analysis/, вне рабочего дерева песочницы: при ошибке «Operation not permitted» нужен доступ на запись. В frontmatter стоит disable-agent-invocation: true, поэтому скилл вызывают явно.

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

  • разобрать выгрузку 23andMe и увидеть критичные фармакогенетические алерты
  • свести массив AncestryDNA с WGS-файлом .vcf.gz в один отчёт
  • проверить статус APOE и полигенные риски с интервалами уверенности
  • прогнать CRAM с референсом hg38 и добрать гомозиготные позиции
  • посмотреть приоритеты находок в agent_summary.json и открыть дашборд

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

  • Проанализируй ~/Downloads/DNA/23andme.txt и покажи сначала критичные алерты
  • Собери один отчёт из ancestry.txt и wgs.vcf.gz и проверь merge_stats.json на реальные конфликты
  • Разбери sample.cram с референсом hg38.fa и добавь результат к отчёту по массиву

Как установить personal-genomics

1Через Skills CLI (Vercel)

npx skills add sammcj/agentic-coding --skill personal-genomics -a claude-code

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

~/.claude/skills/personal-genomics/SKILL.md

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

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

Вопросы о personal-genomics

Как установить personal-genomics в Claude Code?

Выполните npx skills add sammcj/agentic-coding --skill personal-genomics -a claude-code. Скилл появится по пути ~/.claude/skills/personal-genomics/SKILL.md.

Что делает personal-genomics?

Гоняет локальные скрипты по одному или нескольким файлам ДНК и собирает отчёт: фармакогеномика, риски заболеваний, носительство, происхождение, признаки. Плюс полигенные шкалы и статус APOE в виде диапазонов с уверенностью.

Что нужно для разбора CRAM-файла?

Сам .cram с выровненными чтениями, референсный FASTA hg38 с теми же контигами и samtools, bcftools, tabix. Скрипты лежат в каталоге cram/, генотипирование запускает genotype_cram.py.

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

SKILL.md · Apache-2.0
---
name: personal-genomics
description: Analyse personal DNA / genome files for pharmacogenomics, disease risk, carrier status, ancestry and traits. Use whenever the user mentions DNA or genome analysis, a raw genome file, gene names, drug-gene interactions, or wants to combine multiple DNA sources.
disable-agent-invocation: true
allowed-tools: Bash Read Glob SendUserFile
---

# Personal Genomics

Runs the local `personal-genomics` toolkit over one or more raw DNA files and reports the findings. All analysis is offline; genetic data never leaves the machine.

## First: track the workflow

Create a task for each step below, then work them to completion. The run is multi-step and the reporting step (surfacing findings safely) is the one most often skipped once the analysis file is written.

## Locate the toolkit

The scripts and their virtualenv live at `~/git/personal-genomics` (a `.venv/` with pandas/numpy/scipy/reportlab). Use that venv's Python: `~/git/personal-genomics/.venv/bin/python`.

If the repo or venv is missing, set it up before analysing:

```bash
cd ~/git/personal-genomics && python3 -m venv .venv && .venv/bin/pip install -r requirements.txt
```

If the toolkit lives elsewhere, ask the user for the path rather than guessing.

## Locate the input files

Ask the user where their DNA file(s) are if not already given. Common location is `~/Downloads/DNA/`. Supported inputs:

- Array exports: 23andMe, AncestryDNA, MyHeritage, FTDNA (tab-delimited rsid text)
- Sequencing: `.vcf` / `.vcf.gz` (whole genome or exome)

A `.cram.crai` on its own is not usable (it is only an index; the alignment data is in the `.cram` it points to). See Gotchas for what to do when the `.cram` itself is available.

## Choose single-source or combined

**One file** -> `comprehensive_analysis.py`:

```bash
~/git/personal-genomics/.venv/bin/python ~/git/personal-genomics/comprehensive_analysis.py <file> --out <dir>
```

**Two or more files** -> `combine_sources.py`, which merges them first:

```bash
~/git/personal-genomics/.venv/bin/python ~/git/personal-genomics/combine_sources.py <file1> <file2> ... --out <dir>
```

Always merge when more than one source exists. A variants-only VCF (the usual WGS export) lists only sites where the person differs from the reference, so every homozygous-reference site is absent. The marker analysis treats an absent rsID as "not tested" and skips it, which makes a rich WGS file yield *fewer* findings than an array on its own. Merging restores the array's reference/normal calls and keeps the WGS's rare variants, producing a strict superset. The combiner resolves contested sites to the sequencing call and writes `merge_stats.json` recording overlap, agreement, and strand-flip counts.

Outputs land in `<dir>` (suggest `~/dna-analysis/reports` for single, `~/dna-analysis/reports-combined` for merged): `agent_summary.json`, `full_analysis.json`, `report.txt`, `dashboard.html`.

## Report the findings

Read `agent_summary.json` (it is priority-sorted) - not `full_analysis.json`, and never echo the raw genotype data. Surface, in order:

1. `critical_alerts` - state each gene, genotype, and the recommended action verbatim.
2. `high_priority` - pharmacogenomics and actionable risk items.
3. A short read of `polygenic_risk_scores` (these are percentile *ranges* with confidence, not verdicts) and `apoe_status`.

Then offer the dashboard with `SendUserFile` (`display: render`).

Frame results as informational, not diagnostic. Recommend confirmatory clinical-grade testing and genetic counselling for any pathogenic hereditary-cancer variant, critical pharmacogenomic finding (e.g. DPYD, MT-RNR1, HLA-B risk alleles), APOE e4/e4, or carrier status with reproductive implications.

## Gotchas

- **Output directory write**: the tool writes to `~/dna-analysis/` by default, outside a sandboxed working tree. If the run fails with "Operation not permitted", re-run with filesystem write access (this is the user's own data on their own machine).
- **rsID matching is build-agnostic**: markers match by rsID, not position, so hg19 array data and hg38 WGS combine without liftover.
- **Strand flips**: ~0.1% of overlapping sites disagree purely by strand (A/T vs complement); the combiner detects these and resolves to the sequencing call. A non-trivial count of *real* conflicts in `merge_stats.json` is worth flagging to the user.
- **CRAM, when available**: the `.cram` (not the `.crai` index alone) holds the aligned reads, so marker positions can be genotyped directly — giving true hom-ref calls even at sites neither the array nor a variants-only VCF covered. Scripts live in `cram/`. Needs an hg38 reference FASTA matching the CRAM's contigs (the one it was aligned to) and `samtools`/`bcftools`/`tabix`. The marker sites file (`cram/marker_sites_hg38.vcf.gz`) is prebuilt; rebuild it with `cram/build_targets.py` only if markers change. Run:

  ```bash
  ~/git/personal-genomics/.venv/bin/python ~/git/personal-genomics/cram/genotype_cram.py \
    --cram <file.cram> --reference <hg38.fa> \
    --analyze --combine-with <array.txt> <genome.vcf.gz>
  ```

  This calls genotypes at the marker sites, merges them with the other sources, and writes a combined report to `~/dna-analysis/reports-cram`.
- **Empty `nutrition_insights` / `fitness_insights` or a duplicated marker row** are known quirks of the upstream tool, not data problems.

© sammcj · Apache-2.0 · sammcj/agentic-coding

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

Все скиллы по теме «Наука и исследования» →
tooluniverse-regulatory-genomics mims-harvard Скилл tooluniverse-regulatory-genomics ищет регуляторные элементы генома, мотивы связывания факторов транскрипции и оценивает влияние некодирующих мутаций через базы данных и модели. CX Codex +1 247установок Genomics MCP rewire-bio Genomics MCP — MCP-сервер для Claude Code, который по запросу агента находит геномные наборы данных, читает участки файлов и получает сведения о вариантах из справочных баз. CX Codex +1 ★ 5звёзд репо tooluniverse-precision-medicine-stratification mims-harvard Скилл tooluniverse-precision-medicine-stratification для Claude Code разбивает пациентов на группы по геномным, клиническим и терапевтическим данным и формирует для каждой оценку риска и рекомендации по лечению. CX Codex +1 381установок polars-bio K-Dense-AI Интервальная арифметика на Polars DataFrames и I/O для BED, VCF, BAM, CRAM, GFF и FASTQ. Запускает overlap, merge, coverage и complement через polars-bio 0.36.0. CX Codex +1 2 100установок pysam K-Dense-AI Направляет агента при работе с геномными форматами SAM, BAM, CRAM, VCF и FASTA через pysam. Задачи: чтение выравниваний, фильтрация ридов и расчёт покрытия. CX Codex +1 2 100установок encode-ccres-database google-deepmind Скилл encode-ccres-database для Claude Code ищет цис-регуляторные элементы (cCRE) в ENCODE через SCREEN GraphQL API и выгружает данные экспериментов. Находит элементы для анализа промоторов и энхансеров. CX Codex +1 2 300установок

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

Весь набор →
analyse-design Скилл analyse-design для Claude Code анализирует код и скриншоты приложения, сайта или документа и описывает дизайн-систему. Помогает провести аудит интерфейса и создать согласованные компоненты. CX Codex +1 ★ 173звёзд репо invokeai-image-gen Скилл invokeai-image-gen для генерации изображений через локальный API InvokeAI с поддержкой FLUX.2 Klein, Z-Image Turbo и SDXL. Автоматически подбирает параметры под модель, сохраняет результат в файл. CX Codex +1 ★ 173звёзд репо qa-to-issues Скилл qa-to-issues превращает баг-репорты в готовые задачи на GitHub через диалог. Скилл опрашивает вас, изучает репозиторий и сам публикует тикеты без лишних деталей реализации. CX Codex +1 ★ 173звёзд репо systematic-debugging Скилл systematic-debugging для Claude Code пошагово разбирает стойкие баги по изменённой методике Fagan Inspection. Выявляет первопричину после нескольких неудачных попыток исправления. CX Codex +1 ★ 173звёзд репо markedit-tools Скилл markedit-tools помогает обновлять macOS-редактор MarkEdit, подключать расширения и менять настройки программы через Claude Code. CX Codex +1 ★ 173звёзд репо raspberry-pi-pico2 Помогает настраивать сборку и отладку Raspberry Pi Pico 2 и Pi Debug Probe. Охватывает RP2350, SDK, OpenOCD и GDB. CX Codex +1 ★ 173звёзд репо prompt-enhancer Скилл prompt-enhancer для Claude Code превращает неточные промпты в запросы, составленные по образцу экспертной коммуникации. Улучшает собственные запросы и переписывает их для другой ИИ-системы. CX Codex +1 ★ 173звёзд репо piper-tts-training Скилл piper-tts-training для Claude Code готовит датасеты, запускает дообучение и экспортирует голоса Piper в ONNX. Голоса предназначены для синтеза речи на микрокомпьютерах вроде Raspberry Pi. CX Codex +1 ★ 173звёзд репо

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

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