Setup
On first use, read setup.md for integration guidelines. Ask user consent before creating ~/genomics/ workspace.
When to Use
User has processed genomic data (VCF files) and needs clinical interpretation. Agent handles variant classification, pharmacogenomics recommendations, and annotation lookup. NOT for raw data processing — use bioinformatics skill for alignment and variant calling.
Architecture
Memory lives in ~/genomics/. See memory-template.md for structure.
CODEBLOCK0
Quick Reference
| Topic | File |
|---|
| Setup process | INLINECODE5 |
| Memory template |
memory-template.md |
Core Rules
1. Classify Variants Using ACMG Guidelines
Every variant needs systematic classification:
| Category | Criteria |
|---|
| Pathogenic | PVS1, PS1-4, PM1-6, PP1-5 weighted |
| Likely Pathogenic |
Strong + moderate evidence |
| VUS | Insufficient or conflicting evidence |
| Likely Benign | BS1-4, BP1-7 weighted |
| Benign | Strong benign evidence |
Never classify without evidence. State "insufficient data" when appropriate.
2. Check Population Frequency First
Before clinical interpretation, verify frequency:
| Source | Use For |
|---|
| gnomAD v4 | Global population frequency |
| gnomAD non-cancer |
Somatic analysis |
| Population-specific | Ancestry-appropriate filtering |
MAF >1% in any population = likely benign for rare disease.
3. Cross-Reference Multiple Databases
| Database | Information |
|---|
| ClinVar | Clinical classifications + submitter evidence |
| OMIM |
Gene-disease relationships |
| HGMD | Literature-reported mutations |
| UniProt | Protein function + domains |
Single-source interpretation is insufficient. Triangulate evidence.
4. Report Pharmacogenomics Actionably
For drug-gene interactions, provide:
- - Diplotype (e.g., CYP2D6 1/4)
- Predicted phenotype (poor/intermediate/normal/ultra-rapid metabolizer)
- Drug list affected
- Dosing guidance (CPIC/DPWG when available)
5. Separate Germline from Somatic Context
| Context | Key Differences |
|---|
| Germline | Family implications, carrier testing, predictive |
| Somatic |
Tumor-specific, therapy selection, no inheritance |
Always state which context you're interpreting.
6. Acknowledge Uncertainty
- - Novel variants often lack evidence
- VUS ≠ benign — requires ongoing monitoring
- Reclassification happens (ClinVar updates monthly)
- Computational predictions are supportive, not definitive
Pharmacogenomics Reference
High-Priority Drug-Gene Pairs (CPIC Level A)
| Gene | Drugs | Clinical Action |
|---|
| CYP2D6 | Codeine, tramadol, tamoxifen, SSRIs | Dosing/alternative |
| CYP2C19 |
Clopidogrel, PPIs, voriconazole | Dosing/alternative |
| CYP2C9 + VKORC1 | Warfarin | Dosing algorithm |
| DPYD | Fluorouracil, capecitabine | Dose reduction/avoid |
| TPMT + NUDT15 | Azathioprine, mercaptopurine | Dose reduction |
| HLA-B*57:01 | Abacavir | Contraindication |
| HLA-B*15:02 | Carbamazepine | Contraindication (Asian ancestry) |
| SLCO1B1 | Simvastatin | Dose cap/alternative statin |
| G6PD | Rasburicase, primaquine | Contraindication |
| CYP3A5 | Tacrolimus | Dosing adjustment |
Phenotype Interpretation
| Metabolizer Status | Meaning | Typical Action |
|---|
| Poor (PM) | Little/no enzyme activity | Alternative drug or dose ↓↓ |
| Intermediate (IM) |
Reduced activity | Consider dose ↓ |
| Normal (NM) | Expected activity | Standard dosing |
| Rapid/Ultra-rapid (UM) | Increased activity | Dose ↑ or alternative |
Annotation Resources
| Resource | URL | Content |
|---|
| ClinVar | ncbi.nlm.nih.gov/clinvar | Clinical variant classifications |
| gnomAD |
gnomad.broadinstitute.org | Population frequencies |
| OMIM | omim.org | Gene-disease relationships |
| PharmGKB | pharmgkb.org | Drug-gene annotations |
| CPIC | cpicpgx.org | Pharmacogenomics guidelines |
| ClinGen | clinicalgenome.org | Gene-disease validity |
| Franklin | franklin.genoox.com | Variant interpretation aid |
| VarSome | varsome.com | ACMG auto-classification |
Common Interpretation Traps
- - Ignoring population specificity — Variants common in African populations may look rare in European-biased databases
- Trusting single ClinVar submitter — Check submitter count and review status (≥2 submitters, no conflict preferred)
- Conflating computational prediction with evidence — CADD/REVEL are supportive, not diagnostic
- Missing compound heterozygosity — Two VUS in trans can be pathogenic together
- Outdated database versions — gnomAD v4 has 800K+ exomes vs v2's 125K
- Ignoring gene-level constraint — pLI/LOEUF scores indicate tolerance to loss-of-function
External Endpoints
This skill does NOT automatically call external APIs. All database references are for manual lookup:
| Resource | When Used | Data Sent |
|---|
| ClinVar, gnomAD, OMIM | User manually visits | None by this skill |
| PharmGKB, CPIC |
User manually visits | None by this skill |
| VarSome, Franklin | User manually visits | None by this skill |
No automatic network requests. The skill provides URLs and guidance for manual lookup only.
Security & Privacy
Data that stays local:
- - All interpretation work runs locally
- No variant data sent externally by this skill
- No automatic API calls to any database
This skill does NOT:
- - Make network requests automatically
- Upload patient variants anywhere
- Connect to databases without explicit user action
- Store identifiable genomic information outside ~/genomics/
Related Skills
Install with
clawhub install <slug> if user confirms:
- -
medicine — clinical decision support - INLINECODE9 — molecular mechanisms
- INLINECODE10 — drug metabolism pathways
- INLINECODE11 — patient care context
Feedback
- - If useful: INLINECODE12
- Stay updated: INLINECODE13
设置
首次使用时,请阅读 setup.md 获取集成指南。在创建 ~/genomics/ 工作空间前需征得用户同意。
使用场景
用户已处理基因组数据(VCF 文件)并需要临床解读。本技能负责变异分类、药物基因组学建议及注释查询。不适用于原始数据处理——比对和变异检测请使用 bioinformatics 技能。
架构
数据存储于 ~/genomics/ 目录。结构参见 memory-template.md。
~/genomics/
├── memory.md # 上下文 + 偏好 + 解读历史
└── cases/ # 活跃解读案例
快速参考
memory-template.md |
核心规则
1. 使用 ACMG 指南进行变异分类
每个变异需进行系统性分类:
| 类别 | 标准 |
|---|
| 致病性 | PVS1、PS1-4、PM1-6、PP1-5 加权 |
| 可能致病性 |
强证据 + 中等证据 |
| 意义不明确 (VUS) | 证据不足或证据冲突 |
| 可能良性 | BS1-4、BP1-7 加权 |
| 良性 | 强良性证据 |
无证据时不得分类。 适当时应注明数据不足。
2. 优先检查人群频率
在临床解读前,先验证频率:
| 来源 | 用途 |
|---|
| gnomAD v4 | 全球人群频率 |
| gnomAD 非癌症 |
体细胞分析 |
| 人群特异性 | 按祖源筛选 |
任何人群中 MAF >1% = 罕见病中可能为良性。
3. 交叉参考多个数据库
| 数据库 | 信息 |
|---|
| ClinVar | 临床分类 + 提交者证据 |
| OMIM |
基因-疾病关系 |
| HGMD | 文献报道的突变 |
| UniProt | 蛋白质功能 + 结构域 |
单一来源解读不充分。 需三角验证证据。
4. 提供可操作的药物基因组学报告
对于药物-基因相互作用,提供:
- - 双倍型(如 CYP2D6 1/4)
- 预测表型(慢代谢/中间代谢/正常代谢/超快代谢)
- 受影响的药物列表
- 剂量指导(如有 CPIC/DPWG 指南)
5. 区分胚系与体细胞背景
| 背景 | 关键差异 |
|---|
| 胚系 | 家族影响、携带者检测、预测性 |
| 体细胞 |
肿瘤特异性、治疗选择、无遗传性 |
始终说明您正在解读的背景。
6. 承认不确定性
- - 新变异通常缺乏证据
- VUS ≠ 良性——需持续监测
- 重分类时有发生(ClinVar 每月更新)
- 计算预测为辅助性,非决定性
药物基因组学参考
高优先级药物-基因对(CPIC A 级)
| 基因 | 药物 | 临床行动 |
|---|
| CYP2D6 | 可待因、曲马多、他莫昔芬、SSRIs | 调整剂量/换药 |
| CYP2C19 |
氯吡格雷、PPIs、伏立康唑 | 调整剂量/换药 |
| CYP2C9 + VKORC1 | 华法林 | 剂量算法 |
| DPYD | 氟尿嘧啶、卡培他滨 | 减量/避免使用 |
| TPMT + NUDT15 | 硫唑嘌呤、巯嘌呤 | 减量 |
| HLA-B*57:01 | 阿巴卡韦 | 禁忌 |
| HLA-B*15:02 | 卡马西平 | 禁忌(亚洲裔) |
| SLCO1B1 | 辛伐他汀 | 剂量上限/换用他汀 |
| G6PD | 雷布立酶、伯氨喹 | 禁忌 |
| CYP3A5 | 他克莫司 | 剂量调整 |
表型解读
| 代谢状态 | 含义 | 典型行动 |
|---|
| 慢代谢 (PM) | 酶活性低或无 | 换药或大幅减量 |
| 中间代谢 (IM) |
活性降低 | 考虑减量 |
| 正常代谢 (NM) | 预期活性 | 标准剂量 |
| 快速/超快代谢 (UM) | 活性增强 | 增量或换药 |
注释资源
| 资源 | URL | 内容 |
|---|
| ClinVar | ncbi.nlm.nih.gov/clinvar | 临床变异分类 |
| gnomAD |
gnomad.broadinstitute.org | 人群频率 |
| OMIM | omim.org | 基因-疾病关系 |
| PharmGKB | pharmgkb.org | 药物-基因注释 |
| CPIC | cpicpgx.org | 药物基因组学指南 |
| ClinGen | clinicalgenome.org | 基因-疾病有效性 |
| Franklin | franklin.genoox.com | 变异解读辅助 |
| VarSome | varsome.com | ACMG 自动分类 |
常见解读陷阱
- - 忽视人群特异性——在非洲人群中常见的变异,在以欧洲人为主的数据库中可能显得罕见
- 轻信单一 ClinVar 提交者——检查提交者数量和审核状态(优先选择 ≥2 个提交者且无冲突)
- 混淆计算预测与证据——CADD/REVEL 为辅助性,非诊断性
- 遗漏复合杂合性——两个反式 VUS 可能共同致病
- 使用过时数据库版本——gnomAD v4 包含 80 万+外显子组,而 v2 仅 12.5 万
- 忽视基因水平约束——pLI/LOEUF 评分指示对功能缺失的耐受性
外部端点
本技能不会自动调用外部 API。所有数据库参考均为手动查询:
| 资源 | 使用时机 | 发送的数据 |
|---|
| ClinVar、gnomAD、OMIM | 用户手动访问 | 本技能不发送任何数据 |
| PharmGKB、CPIC |
用户手动访问 | 本技能不发送任何数据 |
| VarSome、Franklin | 用户手动访问 | 本技能不发送任何数据 |
无自动网络请求。 本技能仅提供 URL 和指导供手动查询。
安全与隐私
本地保存的数据:
- - 所有解读工作均在本地运行
- 本技能不向外部发送任何变异数据
- 不自动调用任何数据库的 API
本技能不会:
- - 自动发起网络请求
- 在任何地方上传患者变异数据
- 在无用户明确操作下连接数据库
- 在 ~/genomics/ 目录外存储可识别基因组信息
相关技能
如用户确认,使用 clawhub install
安装:
- - medicine——临床决策支持
- biology——分子机制
- chemistry——药物代谢通路
- health——患者护理背景
反馈
- - 如觉有用:clawhub star genomics
- 保持更新:clawhub sync