AgentStack
Browse Sign in
Browse Why AgentStack Sell Docs
Sign in
SKILL verified MIT-0 Self-run

Genomic Variant Interpretation

skill-awslabs-hcls-agent-skills-genomic-variant-interpretation · by awslabs

Reason about germline and somatic variant classification using ACMG/AMP 2015 and AMP/ASCO/CAP frameworks. Use when the user asks to classify a variant, interpret a VCF annotation, resolve a VUS, apply ACMG criteria, weigh ClinVar evidence, evaluate gnomAD allele frequencies, interpret REVEL/CADD/SpliceAI scores, decide whether PVS1 applies, or assess gene-disease validity before reporting. Trigge…

— No reviews yet
0 installs
32 views
0.0% view→install

Install

$ agentstack add skill-awslabs-hcls-agent-skills-genomic-variant-interpretation

✓ scanned · ✓ verified, works with Claude Code, Cursor, and more.

Security review

✓ Passed

No issues found. Passed automated security review. · v0.1.0 How review works →

  • ✓ Prompt-injection patterns
  • ✓ Secret / credential exfiltration
  • ✓ Dangerous shell & filesystem operations
  • ✓ Untrusted network calls
  • ✓ Known-malicious package signatures

What it can access

  • ✓ Network access No
  • ✓ Filesystem access No
  • ✓ Shell / process execution No
  • ✓ Environment & secrets No
  • ✓ Dynamic code execution No

From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.

View the full security report →

Verified badge

Passed review? Show it. Paste this badge into your README, it links to the public security report.

AgentStack Verified badge Links to your public security report.
[![AgentStack Verified](https://agentstack.voostack.com/badges/verified.svg)](https://agentstack.voostack.com/security/report/skill-awslabs-hcls-agent-skills-genomic-variant-interpretation)

Reliability & compatibility

✓ Security review passed
0 installs to date
— no reviews yet
● 2mo ago

Declared compatibility

Claude CodeClaude Desktop

Compatibility is declared by the source manifest. End-to-end runtime verification is coming, see below.

Preview Execution monitoring

We're building live execution health for every listing: tool-call success rate, median latency, uptime, and last-checked timestamps, measured, not self-reported. It isn't live yet, so we don't show numbers we can't stand behind.

How agent discovery & health will work →
Are you the author of Genomic Variant Interpretation? Claim this listing to set pricing, connect Stripe payouts, and keep 70% of every sale.
Sign up to claim

About

Genomic Variant Interpretation

Overview

This is a reasoning skill. It encodes the decision frameworks used in clinical variant interpretation so the agent can help a user classify a genomic variant correctly, justify each piece of evidence, and avoid common pitfalls. It does not run tools or generate code. It assumes the user has variant-level annotation (HGVS nomenclature, population frequency, in silico predictors, ClinVar records, literature) and wants help reasoning about what the variant means.

Two standards dominate:

  • ACMG/AMP 2015 (Richards et al., Genet Med) for germline variants in Mendelian disease, with later ClinGen Sequence Variant Interpretation (SVI) refinements (e.g., PVS1 decision tree, PP3/BP4 quantitative calibration, PM2_Supporting).
  • AMP/ASCO/CAP 2017 (Li et al., JMD) for somatic variants in cancer, organized by clinical actionability tier (I–IV), not pathogenicity.

Confusing these two is the single most common interpretation error. Pick the framework first, then apply it.

Usage

Invoke this skill when the user asks you to:

  • Classify a specific variant (germline or somatic) using ACMG or AMP rules.
  • Decide whether a given ACMG criterion (e.g., PVS1, PM2, PP3) applies to the variant in front of them.
  • Reconcile conflicting evidence (e.g., ClinVar "likely pathogenic" vs. high gnomAD frequency).
  • Resolve a VUS — what evidence would move it up or down.
  • Interpret in silico predictor scores (REVEL, CADD, SpliceAI, AlphaMissense) responsibly.
  • Sanity-check a draft classification before it goes into a clinical report.

When invoked, walk through the Decision Framework section below in order. Do not skip the gene-disease validity check. Cite the specific criterion codes (e.g., "PM2_Supporting because absent from gnomAD v4 with good coverage") rather than vague language ("rare in population").

Response Format

  • Lead with the direct recommendation or classification (≤3 sentences)
  • Structure as: recommendation → justification (citing specific criteria/thresholds) → caveats
  • Use tables for comparisons; bullet points for criteria lists
  • Omit background the user already knows — they asked the question
  • Target: 200-400 words unless the user requests exhaustive detail

The decision trees and frameworks in this skill are for internal reasoning only. Apply them to reach your conclusion, but do not reproduce them in your response. Present only the final recommendation with supporting evidence.

Core Concepts

The five germline tiers (ACMG/AMP 2015)

| Tier | Clinical meaning | | --- | --- | | Pathogenic (P) | Sufficient evidence for disease causation. Reportable. | | Likely pathogenic (LP) | >90% certainty of pathogenicity. Reportable, managed similarly to P. | | Uncertain significance (VUS) | Insufficient or conflicting evidence. Not actionable. Do not use for medical management. | | Likely benign (LB) | >90% certainty of benign. | | Benign (B) | Sufficient evidence against disease causation. |

Evidence criteria (28 total)

Pathogenic evidence is graded by strength: Very Strong (PVS), Strong (PS), Moderate (PM), Supporting (PP). Benign evidence: Stand-alone (BA), Strong (BS), Supporting (BP).

Pathogenic:

  • PVS1 — Null variant (nonsense, frameshift, canonical ±1/2 splice, initiation codon, single/multi-exon deletion) in a gene where loss of function is a known disease mechanism. Subject to the ClinGen PVS1 decision tree (see below).
  • PS1 — Same amino acid change as a previously established pathogenic variant (different nucleotide).
  • PS2 — De novo (paternity and maternity confirmed) in a patient with the disease and no family history.
  • PS3 — Well-established functional studies show a damaging effect.
  • PS4 — Prevalence in affected individuals significantly increased vs. controls (e.g., case-control OR >5).
  • PM1 — Located in a mutational hot spot and/or critical, well-established functional domain without benign variation.
  • PM2 — Absent from (or at extremely low frequency in) population databases. SVI now recommends PM2_Supporting rather than Moderate.
  • PM3 — For recessive disorders, detected in trans with a pathogenic variant.
  • PM4 — Protein length changes due to in-frame indels in a non-repeat region or stop-loss.
  • PM5 — Novel missense change at an amino acid residue where a different missense change has been seen as pathogenic.
  • PM6 — Assumed de novo without confirmation of paternity/maternity.
  • PP1 — Co-segregation with disease in multiple affected family members (upgrade to PS with stronger segregation).
  • PP2 — Missense in a gene with a low rate of benign missense variation and where missense is a common mechanism.
  • PP3 — Multiple computational lines of evidence support a deleterious effect (SVI: use calibrated thresholds, e.g., REVEL).
  • PP4 — Patient phenotype highly specific for a gene with a single etiology.
  • PP5 — Reputable source reports pathogenic (deprecated by SVI — do not use).

Benign:

  • BA1 — Allele frequency >5% in a large, outbred population (e.g., gnomAD).
  • BS1 — Allele frequency greater than expected for the disorder.
  • BS2 — Observed in healthy adults at a dose inconsistent with the disorder (homozygous for recessive, hemizygous for X-linked, heterozygous for dominant).
  • BS3 — Well-established functional studies show no damaging effect.
  • BS4 — Lack of segregation in affected family members.
  • BP1 — Missense in a gene where only truncating variants cause disease.
  • BP2 — Observed in trans with a dominant pathogenic variant, or in cis with a pathogenic variant in any inheritance.
  • BP3 — In-frame indel in a repetitive region without known function.
  • BP4 — Multiple computational lines of evidence suggest no impact (SVI: calibrated).
  • BP5 — Variant found in a case with an alternate molecular basis for disease.
  • BP6 — Reputable source reports benign (deprecated by SVI).
  • BP7 — Synonymous variant with no predicted splice impact and not highly conserved.

Combining rules (ACMG/AMP 2015)

| Classification | Required evidence combinations | | --- | --- | | Pathogenic | (a) 1 PVS1 + ≥1 PS; or (b) 1 PVS1 + ≥2 PM; or (c) 1 PVS1 + 1 PM + 1 PP; or (d) 1 PVS1 + ≥2 PP; or (e) ≥2 PS; or (f) 1 PS + ≥3 PM; or (g) 1 PS + 2 PM + ≥2 PP; or (h) 1 PS + ≥4 PP | | Likely pathogenic | (a) 1 PVS1 + 1 PM; or (b) 1 PS + 1–2 PM; or (c) 1 PS + ≥2 PP; or (d) ≥3 PM; or (e) 2 PM + ≥2 PP; or (f) 1 PM + ≥4 PP | | Benign | 1 BA1; or ≥2 BS | | Likely benign | 1 BS + 1 BP; or ≥2 BP | | VUS | Criteria do not meet any above, or benign and pathogenic evidence conflict |

ClinGen SVI has since introduced a Bayesian point system (Tavtigian et al., 2018) where each strength level has a point value (PVS=8, PS=4, PM=2, PP=1; benign symmetric) and tiers correspond to point ranges. Prefer the point system when modifying criterion strength (e.g., PM2_Supporting = 1 point).

Population frequency — the filtering step

Always apply frequency first. It is the cheapest and most decisive evidence.

  • BA1 (stand-alone benign): allele frequency >5% in any continental population with adequate coverage and sample size (≥2000 alleles). Gene-specific BA1 thresholds exist for some ClinGen VCEPs (e.g., MYH7 uses 0.1%).
  • BS1: frequency greater than expected for the disorder given prevalence, penetrance, allelic and genetic heterogeneity. Use the filtering allele frequency (FAF) — the upper bound of the 95% confidence interval of the population allele frequency — and compare to the maximum credible population AF for the disease.
  • PM2_Supporting: variant absent or at extremely low frequency in gnomAD, in a population relevant to the disease, with adequate read depth. Do not apply PM2 when coverage is poor or the variant is in a low-complexity / segmental duplication region — absence may be artifactual.

Use the largest, most current population reference (gnomAD v4 at time of writing). Exclude founder populations when appropriate. Never rely on 1000 Genomes alone.

Computational predictors — use responsibly

In silico scores are supporting evidence at most unless calibrated by ClinGen for a specific gene.

  • REVEL (missense ensemble, 0–1): SVI-calibrated thresholds are roughly >0.773 PP3Moderate, >0.644 PP3Supporting, 20 ≈ top 1%, >25 ≈ top 0.3%. Popular but not recommended alone for clinical classification — poorly calibrated for missense.
  • SpliceAI (0–1 splice-altering probability): ≥0.2 possible impact, ≥0.5 likely impact, ≥0.8 high confidence. Apply to any variant within ~50 nt of a splice site, including synonymous and deep intronic.
  • AlphaMissense: emerging; treat as one predictor, do not over-weight.

Rules of thumb:

  1. Never base PP3 or BP4 on a single predictor. Use at least two concordant (REVEL + SpliceAI for missense near splice; REVEL + conservation for deep missense).
  2. Do not apply PP3 if the variant type is already captured by PVS1 (nonsense, canonical splice). That would double-count.
  3. Predictors are weaker for in-frame indels and non-coding variants — do not force PP3.

ClinVar — how to read it

ClinVar is a submission database, not ground truth. Weight each assertion by:

  • Review status (stars):
  • ★★★★ practice guideline (e.g., ACMG SF list)
  • ★★★ expert panel (ClinGen VCEP)
  • ★★ multiple submitters, no conflicts
  • ★ single submitter, or conflicting interpretations
  • (no star) no assertion criteria provided

One-star and no-star entries are unreliable on their own. A single commercial lab calling a variant pathogenic without supporting evidence is not sufficient to apply PS1 or influence classification.

  • Date: classifications before ~2016 predate ACMG/AMP and may be outdated. Prefer the most recent submission.
  • Conflicting interpretations: read each submitter's evidence, do not average the calls. Resolve the conflict by going back to the primary evidence.
  • Submitter identity: expert panels > large reference labs > smaller labs > case reports.

ClinVar is appropriate for PS1 (same amino acid change), PM5 (different change at same residue), and as a pointer to primary literature. It is not a substitute for performing your own classification.

PVS1 decision tree (ClinGen SVI 2018)

Not every loss-of-function (LoF) variant deserves full PVS1 strength. Walk this tree:

  1. Is LoF a known disease mechanism for this gene? If the only reported pathogenic variants are missense with gain-of-function or dominant-negative effects, LoF may not cause disease. If unclear, do not apply PVS1 — use lower strength or none.
  2. Variant class:
  • Nonsense or frameshift: go to step 3.
  • Canonical ±1,2 splice: go to step 4.
  • Initiation codon loss: PVS1_Moderate (downstream ATG rescue possible).
  • Single or multi-exon deletion: consider reading frame.
  1. Does the variant predict nonsense-mediated decay (NMD)?
  • Premature termination codon (PTC) in any exon except the last, and more than ~50 nt upstream of the final exon-exon junction → NMD predicted → PVS1 applies.
  • PTC in the last exon or last 50 nt of the penultimate exon → NMD escape → downgrade to PVS1_Strong; also check whether the truncated region is critical to protein function. If the removed region is not functionally critical, downgrade further to Moderate or drop.
  1. Splice variant:
  • Does the variant likely cause exon skipping or intron retention? Predict the reading-frame consequence.
  • In-frame skipping of a non-critical exon → PVS1_Moderate or lower.
  • Out-of-frame skipping with NMD → PVS1.
  1. Rescue transcripts / alternative isoforms: if the affected exon is only included in a minor isoform not expressed in the disease-relevant tissue, downgrade.
  2. Recurrent vs. unique: if multiple unrelated pathogenic LoF variants are already reported in the same exon, confidence increases.

Document which step you applied and at what strength.

Variant type — practical notes

  • Nonsense and frameshift: usually PVS1 (after decision tree). Also consider PM2, PS4, PM3 for recessive.
  • Canonical splice (±1, ±2): PVS1 after decision tree. Support with SpliceAI.
  • Extended splice region (±3 to ±8, exonic near junction, deep intronic): PVS1 does not apply. Use PP3/BP4 with SpliceAI; PS3 if an RNA study confirms aberrant splicing.
  • Missense — the hardest class: cannot use PVS1. Evidence usually comes from PM1 (hotspot/domain), PM2 (rarity), PM5 (another change at residue pathogenic), PP2 (missense-intolerant gene), PP3 (calibrated predictor), PS1 (same amino acid change), PS3 (functional assay). Most variants end up VUS because no single line is strong.
  • In-frame indels: PM4 if not in a repeat; BP3 if in a repeat without known function. Predictors are weak — avoid PP3.
  • Synonymous: usually BP7 unless SpliceAI or conservation flags a splice effect.
  • UTR, deep intronic, regulatory: default to VUS unless functional or splicing evidence exists.

Gene-disease validity — check before you classify

Applying ACMG criteria to a variant in a gene that does not cause the disease in question produces a confidently wrong answer. Before classifying:

  1. Confirm the gene is associated with the patient's phenotype via ClinGen Gene-Disease Validity (Definitive, Strong, Moderate, Limited, Disputed, Refuted, No Known Disease Relationship).
  2. Limited or Disputed → do not report pathogenic calls clinically; the gene itself is not validated.
  3. Confirm the mechanism of disease (LoF, GoF, dominant-negative) — this gates PVS1, PP2, BP1.
  4. Confirm the inheritance pattern — this gates BS2, PM3, and interpretation of heterozygous vs. homozygous observations.

Somatic variants — different framework

For tumor-derived variants, use AMP/ASCO/CAP 2017 tiers, which grade clinical actionability in cancer, not germline pathogenicity. Do not apply ACMG tiers to somatic calls.

| Tier | Meaning | | --- | --- | | I — Strong clinical significance | FDA-approved therapy, included in professional guidelines, or well-powered study with consensus. Levels A (FDA/guideline) and B (well-powered study). | | II — Potential clinical significance | FDA-approved in a different tumor type, investigational therapy with some evidence, or multiple small studies. Levels C and D. | | III — Unknown clinical significance | Not observed at a significant allele frequency in population databases or cancer hotspots; no convincing published evidence of cancer association. | | IV — Benign or likely benign | Observed at significant frequency in population databases; no existing evidence of cancer association. |

Use resources like OncoKB, CIViC, COSMIC (hotspots), and JAX CKB. Distinguish driver vs. passenger, and flag variants that may be germline incidentally found on tumor sequencing (high VAF ~50%, in a cancer predisposition gene) — those need germline confirmation and ACMG classification.

Decision Framework — per variant

Apply these steps in order. Stop when a classification is reached.

  1. Framework selection. Germline → ACMG/AMP. Somatic → AMP/ASCO/CAP. Tumor-normal with a germline incidental finding → both.
  2. Gene-disease validity. Check ClinGen. If Disputed/Refuted, classify as benign for that condition or decline to classify.
  3. Variant nomenclature & transcript. Use a MANE Select or ClinGen-approved transcript. Confirm HGVS is correct.
  4. Population frequency.
  • AF >5% → BA1, classify Benign. Stop.
  • AF > max credible for disease (BS1) → strong benign evidence.
  • Absent / extremely rare with good coverage → PM2_Supporting.
  1. Variant class & PVS1. If predicted LoF, walk the PVS1 decision tree and record the applied strength.
  2. ClinVar & literature. Check stars, date, conf

…

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

Install and usage instructions live in the source repository linked above.

Reviews

No reviews yet, be the first.

Versions

  • v0.1.0 Imported from the upstream source.