tooluniverse-structural-variant-analysis

Interprets structural variants using ACMG-adapted criteria and ClinGen dosage sensitivity scores.

1.7k|254|Updated Mar 3, 2025
One-click install
npx skills add https://github.com/mims-harvard/ToolUniverse --skill tooluniverse-structural-variant-analysis
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tooluniverse-structural-variant-analysis
Source: https://github.com/mims-harvard/ToolUniverse/tree/main/plugins/tooluniverse/skills/tooluniverse-structural-variant-analysis
Command: npx skills add https://github.com/mims-harvard/ToolUniverse --skill tooluniverse-structural-variant-analysis

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Clinical interpretation of structural variants (deletions, duplications, inversions, translocations) requires synthesizing gene content, dosage sensitivity, population frequency, and literature evidence into a defensible ACMG classification, which is slow and error-prone when done manually.

Core Features & Use Cases

  • Seven-phase SV workflow: Normalizes coordinates, annotates gene content, assesses ClinGen HI/TS dosage sensitivity, checks gnomAD/ClinVar/DECIPHER frequencies, scores pathogenicity on a 0-10 scale, and applies ACMG-adapted evidence codes.
  • Five-tier classification with explicit evidence: Produces Pathogenic/Likely Pathogenic/VUS/Likely Benign/Benign calls with per-criterion rationale (PVS1, PS1, PM2, PP4, BA1, etc.) and confidence grading.
  • Structured clinical reports: Generates a standardized markdown report with executive summary, gene tables, scoring breakdown, clinical recommendations, and reproductive risk guidance.
  • Use Case: Given a 283 kb deletion at chr17:31094927-31377677 in a patient with café-au-lait spots, the skill retrieves NF1 dosage sensitivity and ClinVar evidence, classifies the variant as Pathogenic, and outputs a full clinical report with surveillance recommendations.

Quick Start

Interpret the deletion at chr17:31094927-31377677 (GRCh38) in a patient with café-au-lait spots and neurofibromas, and generate a full ACMG classification report.

Frequently Asked Questions about tooluniverse-structural-variant-analysis

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I classify a structural variant using ACMG criteria?

Run the seven-phase workflow: normalize coordinates, annotate gene content, retrieve ClinGen HI/TS dosage scores, check gnomAD and ClinVar frequencies, compute the 0-10 pathogenicity score, gather literature evidence, then apply ACMG evidence codes like PVS1, PS1, and PM2 to reach a five-tier classification.

How do I assess haploinsufficiency for a gene deletion?

Query ClinGen dosage sensitivity for the HI score, where 3 means definitive haploinsufficiency and 2 means likely. Supplement with gnomAD pLI scores (>=0.9 indicates strong LoF intolerance) and OMIM inheritance patterns as weaker supporting evidence.

What variant types does this skill support?

It handles deletions, duplications, inversions, translocations, and complex rearrangements of 50 bp or larger. It does not cover SNVs, small indels under 50 bp, somatic cancer variants, mitochondrial variants, or repeat expansions.

When should I not use structural variant interpretation?

Do not use it for single nucleotide variants or small indels under 50 bp; use the tooluniverse-variant-interpretation skill instead. Somatic cancer variants, mitochondrial variants, and repeat expansions also require different specialized frameworks.

How is reciprocal overlap used to compare SVs in population databases?

Reciprocal overlap is the minimum of the two directional overlap fractions between the query SV and a database SV. A threshold of 70% or higher defines the entries as the same SV, which determines whether ClinVar matches or gnomAD frequencies apply.