clinical-databases/acmg-classification/SKILL.md
Applies ACMG/AMP 2015 framework with ClinGen SVI specifications, Tavtigian 2018/2020 Bayesian point system, Abou Tayoun 2018 PVS1 decision tree, Pejaver 2022 and Bergquist 2025 calibrated PP3/BP4 thresholds for REVEL/BayesDel/AlphaMissense, Brnich 2020 PS3/BS3 OddsPath, Walker 2023 SpliceAI splicing framework, and AMP/ASCO/CAP 2017 tumor tiers. Use when classifying germline variants P / LP / VUS / LB / B, applying VCEP-specific CSpec rules, computing Whiffin BS1, or assigning cancer Tier I-IV per Li 2017.
npx skillsauth add GPTomics/bioSkills bio-clinical-databases-acmg-classificationInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Reference examples tested with: requests 2.31+, pandas 2.2+, AutoPVS1 (Xiang 2020), InterVar 2.2+, GeneBe 1.0+ (Stawiński 2024 Clin Genet). ACMG/AMP Bayesian point system is Tavtigian 2018 Genet Med / 2020 Hum Mutat. Pejaver 2022 AJHG PP3/BP4 calibrated thresholds. ClinGen Splicing Subgroup 2023 (Walker AJHG). v3.2 ACMG SF list (Miller 2023). The ACMG 2.0 framework is in development as of May 2026; not yet published.
Before using code patterns, verify installed versions match. If versions differ:
pip show <package> then help(module.function) to check signatures<tool> --versionIf code throws ImportError, AttributeError, or TypeError, introspect the installed package and adapt the example to match the actual API rather than retrying. VCEP-specific CSpec rules override default ACMG application; the authoritative directory is https://cspec.genome.network/cspec/ui/svi/all.
'Classify this variant per ACMG/AMP' -> Apply 28-criterion framework using Tavtigian point system; gate on ClinGen SVI specifications and VCEP-specific overrides; assign P / LP / VUS / LB / B classification with evidence trail.
https://api.genebe.net/cloud/api-public/v1/variantpython InterVar.py -i input.vcf -b hg38 --table_annovar table_annovar.plRichards 2015 specified 28 criteria with strength labels (Supporting / Moderate / Strong / Very Strong); combination rules produced P / LP / VUS / LB / B. Tavtigian 2018/2020 demonstrated this framework is mathematically a Bayesian classifier and proposed the naturally-scaled point system that every modern automated classifier implements:
| Strength | Points | Odds of pathogenicity | |----------|--------|----------------------| | Supporting | 1 | 2.08:1 | | Moderate | 2 | 4.33:1 | | Strong | 4 | 18.7:1 | | Very Strong | 8 | 350:1 |
Benign codes are negative-signed. Final classification:
| Sum of points | Category | |---------------|----------| | >= 10 | Pathogenic | | 6-9 | Likely Pathogenic | | 0-5 | VUS | | -1 to -6 | Likely Benign | | <= -7 | Benign |
InterVar / GeneBe / VarSome / Franklin all implement Tavtigian point summation under the hood. Combinations never appearing in the 2015 combining rules (e.g., PVS1_VeryStrong + PM2_Supporting -> LP) emerge naturally from point arithmetic.
PVS1 is the most consequential code: pathogenic Very Strong (8 points) for predicted loss-of-function in a gene where LoF is established disease mechanism. The 2018 decision tree refined PVS1 from a binary into a graded code based on:
Output strengths:
| Output | Original Strength | |--------|-------------------| | PVS1_VeryStrong | Strongest (Very Strong) | | PVS1_Strong | Strong | | PVS1_Moderate | Moderate | | PVS1_Supporting | Supporting |
Subsumption rule (Abou Tayoun 2018): PVS1 + PP3 -> only PVS1 counts (PP3 is subsumed). Same for PVS1 + PM4.
>15 VCEP-specific PVS1 trees exist as of 2024 (CDH1, ENIGMA BRCA1/2, FH LDLR/APOB/PCSK9, InSiGHT MMR, RASopathies, hearing loss, hypertrophic cardiomyopathy, Rett/Angelman, etc.). The automated implementation is AutoPVS1 (Xiang 2020).
Pejaver 2022 AJHG 109:2163 Bayesian-calibrated 13 missense predictors to PP3/BP4 strength levels using ClinVar P/B variants with leave-one-gene-out cross-validation.
| Predictor | BP4_Strong | BP4_Moderate | BP4_Supporting | PP3_Supporting | PP3_Moderate | PP3_Strong | Fails when | |-----------|-----------|--------------|----------------|----------------|--------------|------------|-----------| | REVEL | <= 0.016 | <= 0.183 | <= 0.290 | >= 0.644 | >= 0.773 | >= 0.932 | Stacked with BayesDel/VEST4 (training overlap; double-counting) | | BayesDel (no AF) | n/a | <= -0.36 | <= -0.18 | >= 0.13 | >= 0.27 | >= 0.50 | No BP4_Strong reached; combine no-AF version with PM2_Supporting | | VEST4 | n/a | <= 0.302 | <= 0.449 | >= 0.764 | >= 0.861 | >= 0.965 | No BP4_Strong reached; indels (missense-trained); regulatory variants | | MutPred2 | (Pejaver 2022) | -- | -- | -- | -- | -- | Genes with sparse MAVE training data | | AlphaMissense | NOT ClinGen-endorsed | -- | -- | Use as supporting only | -- | NOT ClinGen-endorsed | Developer threshold 0.564 misapplied as PP3 |
The numbers to memorize: REVEL >= 0.932 = PP3_Strong; REVEL <= 0.016 = BP4_Strong (<= 0.003 BP4_VeryStrong); the 0.290-0.644 band is indeterminate (no criterion).
AlphaMissense calibration (Bergquist 2025 Genet Med 27:101402, ClinGen SVI; originally Bergquist et al. bioRxiv 2024.09.17): this ClinGen SVI calibration extends the graded PP3/BP4 options to AlphaMissense, reaching PP3_Strong and at least BP4_Moderate. Critical: the developer-recommended 0.564 threshold is NOT the calibrated PP3 threshold; verify the current ClinGen SVI recommendation for the exact score cutoffs before applying.
Do not stack predictors. REVEL, BayesDel, VEST4 share ClinVar/HGMD training data; using REVEL >= 0.773 AND BayesDel >= 0.27 to claim "two independent moderate hits" is double-counting. Pejaver 2022 explicitly recommends using ONE predictor per variant.
The original PM2 ("absent from controls") was over-weighted. SVI 2020 downgraded to PM2_Supporting (1 point, not 2). Mechanism: most rare variants are benign. Empirical recalibration showed ~6 variants per gene downgrade from LP to VUS when PM2 -> Supporting. Many 2017-2019 LP curations require re-classification post-SVI 2020 update.
OddsPath framework; the four-step SOP:
OddsPath calibration mapping to ACMG strengths:
| OddsPath | Pathogenic strength | Benign strength | |----------|--------------------:|----------------:| | > 18.7 | Very Strong | n/a | | 4.3 - 18.7 | Strong | -- | | 2.1 - 4.3 | Moderate | -- | | 1.2 - 2.1 | Supporting | (mirror) |
MAVEdb deep-mutational scans with >=11 controls (>=5 P/LP + >=5 B/LB) can yield up to PS3_Strong/BS3_Strong via OddsPath calibration. This is the entry point for MAVE/saturation-mutagenesis evidence into ACMG.
Default-Strong PS3 application is increasingly over-strengthening without OddsPath calibration; ClinGen SVI recommends moving toward PS3_Moderate as default unless OddsPath > 4.3.
SpliceAI is the recommended primary splicing tool. Calibrated thresholds:
| SpliceAI DS_max | Strength (Walker 2023: computational splice codes applied at Supporting weight) | |-----------------|----------| | >= 0.2 | PP3_Supporting (minimum threshold for ANY splicing PP3) | | 0.1 - 0.2 | Indeterminate (no criterion) | | <= 0.1 | BP4_Supporting |
SpliceAI prediction alone does NOT reach PP3_Strong; strength escalation requires experimental/RNA splicing evidence (PS3) or the repurposed PVS1 route.
SpliceVault / 300K-RNA (Dawes 2023 Nat Genet 55:324): does NOT predict whether a variant is splice-altering; predicts WHAT the aberrant transcript will be (which exon skips, which cryptic site activates). 96% sensitivity for exon-skipping; 86% for cryptic site activation in 140 clinical RNA-tested cases. Critical for PVS1 application to splice variants because PVS1 depends on whether the aberrant transcript triggers NMD.
Pangolin (Zeng 2022 Genome Biol 23:103): SpliceAI improvement for cryptic donor sites; not yet ClinGen-endorsed but increasingly used as tiebreaker.
BA1 default: AF > 5% in non-bottleneck group per ClinGen SVI; VCEP-specific overrides (Hearing Loss VCEP uses 0.5% AR).
BS1 gene-specific: (prevalence x heterogeneity x allelic-contribution) / (penetrance x 2) from Whiffin 2017 Genet Med 19:1151. Compare against gnomAD grpmax_faf95.
See clinical-databases/gnomad-frequencies for FAF95 details.
| Layer | Authority | Application | |-------|-----------|-------------| | Generic ACMG/AMP 2015 | Richards 2015 | Default fallback | | ClinGen SVI specifications | SVI Working Group | Overrides generic for all genes (PM2 -> Supporting; AutoPVS1 trees; etc.) | | VCEP-specific CSpec | Gene/disease-specific expert panel | Overrides SVI for that gene-disease |
ClinGen VCEP CSpec authoritative registry: https://cspec.genome.network/cspec/ui/svi/all. ~80-90 VCEPs as of 2025. Examples:
Apply VCEP CSpec when one exists. Generic ACMG with no VCEP awareness is unreliable for many genes.
AMP/ASCO/CAP somatic variant interpretation; four tiers:
| Tier | Definition | Action | |------|-----------|--------| | Tier I-A | FDA-approved drug for same tumor type with this biomarker | On-label therapy | | Tier I-B | Professional guidelines (NCCN, ESMO) | Standard-of-care | | Tier II-C | FDA drug in different tumor type (off-label) | Basket trials | | Tier II-D | Preclinical / investigational | Research | | Tier III | VUS-somatic | Watch list | | Tier IV | Benign-somatic | Filter out |
Knowledgebases: OncoKB (MSKCC; Chakravarty 2017), CIViC (Griffith 2017 Nat Genet 49:170), CGI (Tamborero 2018), JAX-CKB, COSMIC. OncoKB Levels (1-4 therapeutic) map to AMP tiers loosely.
The Variant Interpretation for Cancer Consortium (VICC) Meta-Knowledgebase standards (2024-2025) harmonize across knowledgebases. ClinGen Somatic VCEPs are emerging (started 2022).
| Variant type | Recommended workflow | |--------------|----------------------| | Predicted LoF in known LoF-mechanism gene | AutoPVS1 decision tree -> PVS1_VeryStrong/Strong/Moderate/Supporting; check VCEP-specific PVS1 | | Missense in known missense-pathogenic gene | Apply Pejaver 2022 PP3/BP4 calibrated thresholds; ONE predictor only | | Splice variant | SpliceAI DS_max + SpliceVault for aberrant-transcript prediction; PP3_Supporting if DS_max >=0.2 (strength escalation needs RNA/experimental evidence) | | Synonymous | SpliceAI for cryptic splice effect; synVep / PrimateAI synonymous extension | | Variant in ACMG SF v3.2 gene | Apply full classification; flag P/LP for opt-in disclosure | | Cancer somatic variant | AMP/ASCO/CAP 2017 Tier I-IV; cross-check OncoKB / CIViC | | Variant in Limited gene-disease validity | ClinGen Strong/Definitive required for clinical action | | Functional evidence available | Brnich 2020 PS3/BS3 OddsPath framework | | Family segregation | PP1 / BS4 LOD score per Biesecker 2024 | | In-trans observations (AR) | PM3 with ClinGen tabular scoring system | | HGVS-c on alternative transcript | Re-evaluate on MANE Select |
Goal: Apply ACMG/AMP framework to a candidate variant with proper SVI specifications and VCEP overrides.
Approach: Pull aggregated evidence; apply Pejaver-calibrated in-silico thresholds; check VCEP-specific CSpec; sum Tavtigian points.
import requests
import pandas as pd
# Pejaver 2022 calibrated REVEL thresholds (one-predictor rule applies)
REVEL_THRESHOLDS = {
'BP4_VeryStrong': (-float('inf'), 0.003),
'BP4_Strong': (0.003, 0.016),
'BP4_Moderate': (0.016, 0.183),
'BP4_Supporting': (0.183, 0.290),
# (0.290, 0.644) = indeterminate zone, no criterion applied
'PP3_Supporting': (0.644, 0.773),
'PP3_Moderate': (0.773, 0.932),
'PP3_Strong': (0.932, float('inf'))
}
# Tavtigian point assignments (Tavtigian 2020 Hum Mutat)
STRENGTH_POINTS = {
'PVS1_VeryStrong': 8, 'PVS1_Strong': 4, 'PVS1_Moderate': 2, 'PVS1_Supporting': 1,
'PS1': 4, 'PS2': 4, 'PS3': 4, 'PS3_Moderate': 2, 'PS3_Supporting': 1, 'PS4': 4,
'PM1': 2, 'PM2_Supporting': 1, 'PM3': 2, 'PM3_Strong': 4, 'PM3_VeryStrong': 8,
'PM4': 2, 'PM5': 2, 'PM6': 2,
'PP1': 1, 'PP1_Moderate': 2, 'PP1_Strong': 4,
'PP2': 1, 'PP3_Supporting': 1, 'PP3_Moderate': 2, 'PP3_Strong': 4, 'PP4': 1, 'PP5': 1,
# Benign codes (negative)
'BA1': -100, # Standalone benign
'BS1': -4, 'BS2': -4, 'BS3': -4, 'BS3_Moderate': -2, 'BS3_Supporting': -1, 'BS4': -4,
'BP1': -1, 'BP2': -1, 'BP3': -1,
'BP4_Supporting': -1, 'BP4_Moderate': -2, 'BP4_Strong': -4, 'BP4_VeryStrong': -8,
'BP5': -1, 'BP6': -1, 'BP7': -1
}
def classify_revel_pp3_bp4(revel_score):
'''Map REVEL score to PP3/BP4 strength per Pejaver 2022.'''
if revel_score is None:
return None
for code, (lo, hi) in REVEL_THRESHOLDS.items():
if lo <= revel_score < hi:
return code
return None
def classify_alphamissense_supporting_only(am_score):
'''AlphaMissense is currently supporting-only; ClinGen has not endorsed PP3 calibration.
Cheng 2023 developer threshold 0.564 is NOT the Pejaver-style PP3 calibration.
'''
if am_score is None:
return None
if am_score >= 0.7:
return 'PP3_Supporting' # Tentative; ClinGen not endorsed
if am_score <= 0.2:
return 'BP4_Supporting' # Tentative
return None
def spliceai_to_acmg(ds_max):
'''Walker 2023 SVI Splicing Subgroup framework.
Computational SpliceAI codes are applied at Supporting weight.
SpliceAI >= 0.20 -> PP3_Supporting (minimum for ANY splicing PP3).
SpliceAI <= 0.1 -> BP4_Supporting.
Prediction alone does not reach PP3_Strong; escalation needs RNA/experimental evidence.
'''
if ds_max is None:
return None
if ds_max >= 0.20:
return 'PP3_Supporting'
if ds_max <= 0.1:
return 'BP4_Supporting'
return None
def tavtigian_classify(criteria_assigned):
'''Sum Tavtigian points and classify P / LP / VUS / LB / B.
criteria_assigned: list of criterion strings (e.g., ['PVS1_VeryStrong', 'PM2_Supporting'])
'''
points = sum(STRENGTH_POINTS.get(c, 0) for c in criteria_assigned)
if any(c == 'BA1' for c in criteria_assigned):
return {'classification': 'Benign', 'points': points, 'rationale': 'BA1 standalone'}
if points >= 10:
category = 'Pathogenic'
elif points >= 6:
category = 'Likely Pathogenic'
elif points >= 0:
category = 'VUS'
elif points >= -6:
category = 'Likely Benign'
else:
category = 'Benign'
return {'classification': category, 'points': points, 'criteria': criteria_assigned}
def genebe_classify(hgvs):
'''Query GeneBe API (Stawiński 2024) for automated ACMG classification.
GeneBe is open-source, Tavtigian-point-system-based, and performs comparably to
VarSome (which is commercial, 82% ACMG criteria auto-application rate).
'''
r = requests.get(f'https://api.genebe.net/cloud/api-public/v1/variant',
params={'variant': hgvs, 'genome': 'hg38'},
timeout=30)
r.raise_for_status()
return r.json()
def whiffin_max_credible_af(prevalence, max_allelic_contribution=1.0,
max_genetic_contribution=1.0, penetrance=1.0):
'''Compute gene-specific BS1 max-credible-AF (Whiffin 2017 Genet Med).
Returns: max-credible per-allele frequency under dominant inheritance.
For autosomal recessive, transform appropriately.
'''
return (prevalence * max_genetic_contribution * max_allelic_contribution) / (penetrance * 2)
def apply_bs1_ba1(grpmax_faf95, max_credible_af, ba1_threshold=0.05):
'''Apply ClinGen SVI BS1/BA1 from gnomAD grpmax FAF95.'''
if grpmax_faf95 is None or grpmax_faf95 == 0.0:
return 'PM2_Supporting'
if grpmax_faf95 > ba1_threshold:
return 'BA1'
if grpmax_faf95 > max_credible_af:
return 'BS1'
return None
1. Stacking REVEL + BayesDel + VEST4 as independent evidence
2. AlphaMissense PP3_Strong with developer 0.564 threshold
3. PVS1 applied to nonsense variant in GoF gene
4. Generic ACMG instead of VCEP CSpec
https://cspec.genome.network/cspec/ui/svi/all for active VCEP; apply gene-specific CSpec.5. PM2 at Moderate (pre-2020 SVI)
6. PS3 default Strong without OddsPath
7. Synonymous treated as no impact
8. ClinVar P + ClinGen Limited validity
9. Variant on wrong transcript
--mane_select.| Pattern | Likely cause | Action | |---------|-------------|--------| | GeneBe LP vs VarSome P | Different VCEP-specific application | Check VCEP CSpec; apply gene-specific rules | | ClinVar P vs my classification VUS | Submission stale OR my evidence incomplete | Re-curate with current evidence; check ClinVar star + freshness | | REVEL PP3_Strong vs SpliceAI BP4 | Variant has missense impact but no splice impact | Apply ONE predictor; if splice-altering, PVS1 trumps | | PVS1 applies but ClinGen Limited validity | Variant-level vs gene-disease tension | Treat as candidate; require VCEP or strong functional evidence | | ClinGen VCI vs automated tool | VCI is gold standard for expert curation | Trust VCI; automated tools approximate | | AlphaMissense 0.564 dev call vs calibrated strength | Developer threshold not calibrated | Use the ClinGen SVI calibrated cutoffs (Bergquist 2025) |
| Threshold | Convention | Source | |-----------|-----------|--------| | Tavtigian P | >= 10 points | Tavtigian 2020 | | Tavtigian LP | 6-9 points | Tavtigian 2020 | | Tavtigian VUS | 0-5 points | Tavtigian 2020 | | Tavtigian LB | -1 to -6 | Tavtigian 2020 | | Tavtigian B | <= -7 | Tavtigian 2020 | | REVEL PP3_Strong | >= 0.932 | Pejaver 2022 | | REVEL BP4_Strong | <= 0.016 | Pejaver 2022 | | SpliceAI PP3 (Supporting) | >= 0.2 | Walker 2023 | | SpliceAI BP4 (Supporting) | <= 0.1 | Walker 2023 | | BA1 default | grpmax_faf95 > 5% | ClinGen SVI | | BS1 | grpmax_faf95 > gene-specific max-credible-AF | Whiffin 2017 | | PM2 -> PM2_Supporting | Always (post-SVI 2020) | SVI 2020 | | PS3 OddsPath Strong | > 4.3 | Brnich 2020 | | PVS1 LoF mechanism check | Required (do not apply if GoF) | Abou Tayoun 2018 | | ACMG SF v3.2 | 81 genes | Miller 2023 | | Cancer Tier I-A | FDA drug + same tumor + this biomarker | Li 2017 |
| Symptom | Cause | Solution | |---------|-------|----------| | Over-application of PP3 | Multiple predictors stacked | ONE predictor only | | AlphaMissense PP3_Strong from dev threshold | 0.564 not calibrated | Use Pejaver-style REVEL | | LP variant in gene with Limited validity | No gene-disease gate | Apply ClinGen gene-disease validity | | PVS1 in GoF gene | Wrong mechanism | Check ClinGen gene-disease mechanism | | Non-VCEP rule for VCEP-covered gene | Generic ACMG | Apply VCEP CSpec | | PM2 = Moderate | Pre-SVI 2020 | Use PM2_Supporting | | PS3 = Strong default | No OddsPath | Apply Brnich 2020 OddsPath |
| Pushback | Standard response |
|----------|-------------------|
| "Why Tavtigian point system?" | Every modern automated classifier implements it (InterVar, GeneBe, VarSome, Franklin). The 2015 combining rules are subsumed; many P/LP combinations only emerge from points. |
| "Why ONE predictor and not REVEL + BayesDel?" | Pejaver 2022 explicit recommendation; predictors share training data. |
| "AlphaMissense PP3_Strong?" | ClinGen SVI calibrated AlphaMissense to graded PP3/BP4 (Bergquist 2025); use the calibrated cutoffs, not the developer 0.564 threshold. |
| "PVS1 for nonsense in SCN5A LQT3" | LQT3 is GoF; LoF mechanism not established; PVS1 does not apply. |
| "Generic ACMG vs VCEP" | VCEP CSpec overrides generic; we check cspec.genome.network for active VCEP. |
| "Splice variant PP3 from SpliceAI" | Walker 2023 SVI Splicing Subgroup: DS_max >= 0.2 applies PP3 at Supporting weight; prediction alone does not reach PP3_Strong (needs RNA/experimental evidence). |
| "PM2 Moderate or Supporting?" | SVI 2020 downgraded to Supporting; we use Supporting for all classification post-2020. |
https://cspec.genome.network/cspec/ui/svi/allhttps://curation.clinicalgenome.org/development
Installs 425 bioinformatics skills covering sequence analysis, RNA-seq, single-cell, variant calling, metagenomics, structural biology, and 56 more categories. Use when setting up bioinformatics capabilities or when a bioinformatics task requires specialized skills not yet installed.
testing
Chains a somatic (tumor-normal) SNV/indel and structural-variant pipeline end to end with GATK Mutect2 (or Strelka2), wiring the somatic-specific machinery - panel-of-normals and gnomAD germline-resource priors, GetPileupSummaries/CalculateContamination, and LearnReadOrientationModel FFPE/oxoG orientation-bias filtering fed into FilterMutectCalls. Use when calling somatic mutations from a tumor-normal pair (or tumor-only with PoN caveats), deciding which artifact filter removes which class of false positive, reasoning about VAF/purity/ploidy and clonal-vs-subclonal detection, adding somatic SV/CNV or TMB/MSI/signatures, or routing variants to AMP/ASCO/CAP tier and oncogenicity interpretation (never germline ACMG).
development
End-to-end pooled and single-cell CRISPR screen analysis from FASTQ to hit genes. Orchestrates library design QC, guide counting, six-stage screen QC (plasmid Gini, replicate Pearson, CEGv2 PR-AUC, copy-number artifact), method-appropriate hit calling across MAGeCK RRA/MLE, BAGEL2, drugZ, JACKS, and Chronos, cancer-cell-line copy-number correction (CRISPRcleanR / Chronos), batch correction for multi-batch screens, and the specialized branches for combinatorial paralog screens, single-cell Perturb-seq, base-editor variant-function screens, prime-editor screens, and in vivo bottleneck-aware screens. Use when analyzing any pooled CRISPR screen end-to-end, matching the hit-calling method to the experimental design, integrating copy-number correction into the pipeline, or branching the workflow for single-cell, combinatorial, base-editor, prime-editor, or in vivo variants.
development
Transcribe DNA to RNA and translate to protein using Biopython, with NCBI codon-table selection, CDS validation, and six-frame ORF finding. Use when converting a CDS or ORF to its amino-acid sequence, selecting a non-standard (mitochondrial, bacterial, ciliate) genetic code, validating a coding sequence, or scanning all reading frames.