tooluniverse-structural-variant-analysis
/tooluniverse-structural-variant-analysis
Comprehensive structural variant (SV) analysis skill for clinical genomics. Classifies SVs (deletions, duplications, inversions, translocations), assesses pathogenicity using ACMG-adapted criteria, evaluates gene disruption and dosage sensitivity, and provides clinical interpretation with evidence grading. Use when analyzing CNVs, large deletions/duplications, chromosomal rearrangements, or any structural variants requiring clinical interpretation.
- Author
- zaoqu-liu ↗
- Repository
- scienceclaw ↗
- Licence
- MIT
- Last repository change
- 10.11.2026
Assessment and security
- Files in this package
- 2
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 10.11.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
Comprehensive structural variant (SV) analysis skill for clinical genomics. Classifies SVs (deletions, duplications, inversions, translocations), assesses pathogenicity using ACMG-adapted criteria, evaluates gene disruption and dosage sensitivity, and provides clinical interpretation with evidence grading. Use when analyzing CNVs, large deletions/duplications, chromosomal rearrangements, or any structural variants requiring clinical interpretation.
Original author description
Comprehensive structural variant (SV) analysis skill for clinical genomics. Classifies SVs (deletions, duplications, inversions, translocations), assesses pathogenicity using ACMG-adapted criteria, evaluates gene disruption and dosage sensitivity, and provides clinical interpretation with evidence grading. Use when analyzing CNVs, large deletions/duplications, chromosomal rearrangements, or any structural variants requiring clinical interpretation.
How it works
- Triggers
- Workflow (7 Phases)
- Report Template
SKILL.md preview
--- name: tooluniverse-structural-variant-analysis description: Comprehensive structural variant (SV) analysis skill for clinical genomics. Classifies SVs (deletions, duplications, inversions, translocations), assesses pathogenicity using ACMG-adapted criteria, evaluates gene disruption and dosage sensitivity, and provides clinical interpretation with evidence grading. Use when analyzing CNVs, large deletions/duplications, chromosomal rearrangements, or any structural variants requiring clinical interpretation. --- # Structural Variant Analysis Workflow Systematic analysis of structural variants (deletions, duplications, inversions, translocations, complex rearrangements) for clinical genomics interpretation using ACMG-adapted criteria. **KEY PRINCIPLES**: 1. **Report-first approach** - Create SV_analysis_report.md FIRST, then populate progressively 2. **ACMG-style classification** - Pathogenic/Likely Pathogenic/VUS/Likely Benign/Benign with explicit evidence 3. **Evidence grading** - Grade all findings by confidence level (★★★/★★☆/★☆☆) 4. **Dosage sensitivity critical** - Gene dosage effects drive SV pathogenicity 5. **Breakpoint precision matters** - Exact gene disruption vs dosage-only effects 6. **Population context essential** - gnomAD SVs for frequency assessment 7. **English-first queries** - Always use English terms in tool calls --- ## Triggers Use this skill when users: - Ask about structural variant interpretation or CNV data - Ask "is this deletion/duplication pathogenic?" - Need ACMG classification for SVs or gene dosage assessment - Have chromosomal rearrangements requiring interpretation **NOT for**: SNV/indel interpretation → `tooluniverse-variant-interpretation`; gene enrichment → `tooluniverse-gene-enrichment` --- ## Workflow (7 Phases) ### Phase 1: SV Identity & Classification Normalize coordinates (hg19/hg38), determine type (DEL/DUP/INV/TRA/CPX), calculate size, assess breakpoint precision. | SV Type | Abbreviation | Molecular Effect | |---------|-------------|------------------| | Deletion | DEL | Haploinsufficiency, gene disruption | | Duplication | DUP | Triplosensitivity, dosage imbalance | | Inversion | INV | Gene disruption at breakpoints, position effects | | Translocation | TRA | Gene fusions, disruption, position effects | | Complex | CPX | Variable effects | ### Phase 2: Gene Content Analysis Identify genes fully contained in SV and genes with breakpoints (disrupted). Annotate function and disease associations. | Tool | Purpose | |------|---------| | `Ensembl_lookup_gene` | Gene structure, coordinates, exons | | `NCBI_gene_search` | Official symbol, description | | `OMIM_search` + `OMIM_get_entry` | Disease associations, inheritance | | `DisGeNET_search_gene` | Gene-disease evidence scores | | `Gene_Ontology_get_term_info` | Biological process, molecular function | ### Phase 3: Dosage Sensitivity Assessment ```python from tooluniverse import ToolUniverse tu = ToolUniverse(use_cache=True); tu.load_tools() # ClinGen dosage (gold standard) clingen = tu.tools.ClinGen_search_dosage_sensitivity(gene="KANSL1") # -> hi_score: 3 = Sufficient evidence for HI # ClinGen gene validity validity = tu.tools.ClinGen_search_gene_validity(gene="KANSL1") # -> Classification: Definitive # gnomAD constraint (pLI) gnomad = tu.tools.gnomad_get_gene_constraints(gene_symbol="KANSL1") # -> pLI close to 1.0 = loss-of-function intolerant # OMIM inheritance omim = tu.tools.OMIM_search(operation="search", query="KANSL1", limit=3) ``` **Evidence grading**: HI/TS score=3 + Definitive validity = ★★★ | Score 2-3 = ★★☆ | Otherwise = ★☆☆ ### Phase 4: Population Frequency Context | Tool | Purpose | |------|---------| | `gnomad_search` | Population SV frequencies, overlapping SVs | | `ClinVar_search_variants` | Known pathogenic/benign SVs (chromosome, start, stop, variant_type) | | `DECIPHER_search` | Patient SVs with phenotypes, case reports | **ACMG frequency codes**: - ≥1% in gnomAD SVs → BA1 (Stand-alone Benign) - 0.1-1% → BS1 (Strong Benign) - <0.01% or absent → PM2 (Supporting Pathogenic) **Reciprocal overlap**: min(overlap/SV_A_length, overlap/SV_B_length) ≥70% = "same" SV ### Phase 5: Pathogenicity Scoring (0-10) | Component | Weight | Max Points | |-----------|--------|-----------| | Gene content | 40% | 4 pts: dosage-sensitive gene disrupted; 3: disease gene fully contained; 2: OMIM gene; 1: any gene | | Dosage sensitivity | 30% | 3 pts: HI/TS score=3 + Definitive validity; 2: score 2-3; 1: predicted only | | Population frequency | 20% | 2 pts: absent from gnomAD+DGV; 1: rare (<0.01%); 0: common | | Clinical match | 10% | 1 pt: phenotype consistent + literature support | **Score interpretation**: - **9-10**: Pathogenic | **7-8.9**: Likely Pathogenic | **4-6.9**: VUS | **2-3.9**: Likely Benign | **0-1.9**: Benign ### Phase 6: Literature & Clinical Evidence | Tool | Purpose | |------|---------| | `PubMed_search_articles` | Similar SVs, gene disruption studies (returns plain list) | | `DECIPHER_search` | Developmental disorder cases with overlapping SVs | | `EuropePMC_search_articles` | Broader literature search | ### Phase 7: ACMG-Adapted Classification **Key pathogenic codes for SVs**: - PVS1: Gene disruption of established HI gene (Very Strong) - PS1: Same SV as known pathogenic in ClinVar (Strong) - PS3: Functional studies confirm dosage sensitivity (Strong) - PM2: Absent from population databases (Moderate) - PP4: Patient phenotype matches gene's disease (Supporting) **Key benign codes**: - BA1: ≥1% frequency in gnomAD SVs (Stand-alone) - BS1: 0.1-1% frequency (Strong) - BP1: No known disease genes in region (Supporting) **Classification**: 1 Very Strong + 1 Strong = Pathogenic | 1 Very Strong + 1-2 Moderate = Likely Pathogenic | Contradictory = VUS --- ## Report Template | Section | Content | |---------|---------| | 1. SV Summary | Type, coordinates, size, breakpoint precision | | 2. Gene Content | Fully contained genes, disrupted genes, regulatory elements | | 3. Dosage Sensitivity | ClinGen HI/TS scores, pLI, validity level per gene | | 4. Population Frequency | gnomAD/ClinVar/DECIPHER overlaps, ACMG codes | | 5. Pathogenicity Score | 0-10 score with component breakdown | | 6. Literature Evidence | Key publications, DECIPHER cases, functional evidence | | 7. ACMG Classification | Evidence codes applied, final classification + rationale | | 8. Clinical Recommendations | Immediate actions, further investigation, genetic counseling | --- > **Extended Reference**: Full Python implementations for each phase, detailed ACMG criteria tables, example reports, and edge case handling are in `REFERENCE.md`.
Files in this package (2)
- REFERENCE.md 43 KB
- SKILL.md 7 KB
Versions
| Repository | Score | Licence |
|---|---|---|
| This page · zaoqu-liu/scienceclaw | 100 | MIT |
| mims-harvard/ToolUniverse | 100 | Apache-2.0 |
Database snapshot: 13.11.2026 · package version 1f17bffe19b2 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100tooluniverse-variant-interpretation
Systematic clinical variant interpretation from raw variant calls to ACMG-classified recommendations with structural impact analysis. Aggregates evidence from ClinVar, gnomAD, CIViC, UniProt, and PDB across ACMG criteria. Produces pathogenicity scores (0-100), clinical… - 87tooluniverse-variant-analysis
Production-ready VCF processing, variant annotation, mutation analysis, and structural variant (SV/CNV) interpretation for bioinformatics questions. Parses VCF files (streaming, large files), classifies mutation types (missense, nonsense, synonymous, frameshift, splice,… - 100tooluniverse-variant-interpretation
Clinical variant interpretation from raw variant calls to ACMG-classified recommendations with structural impact analysis. Use for VUS classification, pathogenicity assessment with cited criteria, structure-based variant impact (AlphaFold/PDB), non-coding/regulatory variant… - 100tooluniverse-acmg-variant-classification
Systematic ACMG/AMP germline variant classification with all 28 criteria (PVS1, PS1-4, PM1-6, PP1-5, BA1, BS1-4, BP1-7) for clinical significance. Produces 5-tier verdict (Pathogenic / Likely Pathogenic / VUS / Likely Benign / Benign) with cited evidence per criterion. Use for… - 95bio-variant-calling-clinical-interpretation
Classify variant clinical significance with the ACMG/AMP germline framework and its 2018-2025 ClinGen refinements (graded PVS1 decision tree, PM2 downgraded to Supporting, PP5/BP6 retired, calibrated PP3/BP4, Bayesian points), the AMP/ASCO/CAP somatic tiers and ClinGen… - 100genomics-variant-interpretation
Use when interpreting genomic variants from VCF files, performing clinical variant classification using ClinVar/VEP annotations, analyzing allele frequencies against population data (1000 Genomes), or generating clinical reports for genetic counseling.