snv-judge

Predict pathogenicity of human missense SNVs with calibrated probabilities and ACMG classifications.

1|Updated Mar 4, 2026
One-click install
npx skills add https://github.com/zja2004/SNV-judge --skill snv-judge
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: snv-judge
Source: https://github.com/zja2004/SNV-judge/tree/main/skill
Command: npx skills add https://github.com/zja2004/SNV-judge --skill snv-judge

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires numpy, pandas, requests, xgboost, lightgbm, scikit-learn, shap, and includes scripts (resource) and references (resource) components.

What problem does it solve?

SNV-judge provides calibrated, ACMG-aware pathogenicity predictions for human missense single-nucleotide variants (SNVs) by integrating 8 heterogeneous features from free public sources, enabling clinicians and researchers to interpret variants with quantitative probabilities and actionable classifications.

Core Features & Use Cases

  • Calibrated probability of pathogenicity (0–1) and ACMG 5-tier classification (P/LP/VUS/LB/B) for missense SNVs.
  • Per-feature SHAP contributions with visual explanations, supporting transparent interpretation.
  • Optional clinical interpretation reports generated via LLM templates (Chinese/English/summary).

Quick Start

Provide a chrom/pos/ref/alt or protein change and run predict_variant to obtain a calibrated pathogenicity probability, ACMG classification, and SHAP explanations.

Frequently Asked Questions about snv-judge

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

FAQPage Schema
How do I predict SNV pathogenicity and get an ACMG classification from a VCF file?

You can predict missense SNV pathogenicity by processing single variants or VCF batches to receive calibrated probability scores and 5-tier ACMG classifications (P/LP/VUS/LB/B) without needing API keys.

Can I interpret clinical genomics variants using SHAP explanations?

Yes, clinical genomics variant interpretation includes per-feature SHAP contributions, providing visual explanations that detail how eight public-source features influence the calibrated pathogenicity probability.

Does this pathogenicity prediction tool require API keys for basic variant queries?

No, basic variant queries require no API keys, as the tool uses eight free public-source features to deliver calibrated pathogenicity probabilities and ACMG classifications for missense SNVs.

What is the best way to generate a clinical interpretation report for missense variants?

The best way to generate a clinical interpretation report is by using optional LLM templates, which produce Chinese, English, or summary reports based on calibrated pathogenicity predictions and ACMG classifications.

How do I query missense SNV pathogenicity using a protein change instead of genomic coordinates?

You can query missense SNV pathogenicity by providing a protein change instead of genomic coordinates, allowing the model to predict calibrated pathogenicity probabilities and ACMG classifications.

What machine learning dependencies are needed for SNV pathogenicity prediction and model explainability?

SNV pathogenicity prediction and model explainability rely on xgboost, lightgbm, scikit-learn, and shap to process eight public-source features and generate calibrated probability scores with visual explanations.