clinvar-database
/clinvar-database
Utilities for querying the NCBI ClinVar database to retrieve variant records, clinical significance, and phenotype relationships; use when searching variants by gene/condition/significance, interpreting Pathogenic/Benign/VUS classifications, or annotating VCF files with ClinVar annotations.
- Author
- aipoch ↗
- Repository
- medical-research-skills ↗
- Licence
- MIT
- Last repository change
- 17.09.2026
Assessment and security
- Files in this package
- 6
- Scripts
- 2
- HTML comments
- 0
- URLs in SKILL.md
- 2
No signals detected. Repository changed on 17.09.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
- 2 scripts in this package. Review them before installing, as Claude may execute them.
Scripts: scripts/annotate.py, scripts/search.py
What it does and when to use it
Utilities for querying the NCBI ClinVar database to retrieve variant records, clinical significance, and phenotype relationships; use when searching variants by gene/condition/significance, interpreting Pathogenic/Benign/VUS classifications, or annotating VCF files with ClinVar annotations.
Original author description
Utilities for querying the NCBI ClinVar database to retrieve variant records, clinical significance, and phenotype relationships; use when searching variants by gene/condition/significance, interpreting Pathogenic/Benign/VUS classifications, or annotating VCF files with ClinVar annotations.
How it works
- When to Use
- Key Features
- Dependencies
- Example Usage
- Implementation Details
SKILL.md preview
--- name: clinvar-database description: Utilities for querying the NCBI ClinVar database to retrieve variant records, clinical significance, and phenotype relationships; use when searching variants by gene/condition/significance, interpreting Pathogenic/Benign/VUS classifications, or annotating VCF files with ClinVar annotations. license: MIT author: AIPOCH --- > **Source**: [https://github.com/aipoch/medical-research-skills](https://github.com/aipoch/medical-research-skills) ## When to Use - You need to find ClinVar variant records by **gene**, **condition/phenotype**, or **clinical significance** (e.g., *BRCA1* + *pathogenic*). - You want to interpret a variant’s **clinical significance** (Pathogenic/Benign/VUS) and **review status** for reporting or triage. - You need to **annotate a VCF** with ClinVar identifiers and interpretation fields as part of a variant annotation pipeline. - You want to perform **bulk retrieval** of ClinVar datasets for offline analysis or periodic database refresh. - You are building a workflow that relies on **NCBI E-utilities** to programmatically query ClinVar. ## Key Features - **ClinVar search** via NCBI E-utilities using flexible query terms (gene/condition/significance). - **Clinical interpretation retrieval**, including clinical significance categories and review status. - **VCF annotation** workflow integration (leveraging `bcftools`) to enrich variants with ClinVar data. - **Bulk data access** through ClinVar FTP downloads for large-scale processing. - Reference documentation: - API details: `references/api_reference.md` - Clinical significance definitions: `references/clinical_significance.md` ## Dependencies - Python `>=3.8` - `requests` (Python package) - `bcftools` (system dependency; required for VCF annotation) - `pandas` (Python package; optional for downstream data processing) ## Example Usage ### 1) Search ClinVar for pathogenic variants in a gene ```bash python scripts/search.py --term "BRCA1[gene] AND pathogenic[CLNSIG]" ``` ### 2) Annotate a VCF with ClinVar data ```bash python scripts/annotate.py --input input.vcf --output annotated.vcf ``` ## Implementation Details - **Search (`scripts/search.py`)** - Uses **NCBI E-utilities** to query ClinVar with a user-provided `--term`. - The query term supports ClinVar/Entrez syntax (e.g., `BRCA1[gene]`, `pathogenic[CLNSIG]`) to filter by gene and clinical significance. - Output is expected to include matching ClinVar records/identifiers suitable for follow-up interpretation or annotation. - **Interpretation fields** - Clinical significance values (e.g., Pathogenic/Benign/VUS) and related interpretation guidance follow ClinVar conventions; see `references/clinical_significance.md`. - Review status (e.g., level of evidence/review) is retrieved alongside significance where available. - **VCF annotation (`scripts/annotate.py`)** - Takes an input VCF (`--input`) and produces an annotated VCF (`--output`). - Integrates with `bcftools` to add ClinVar-derived annotations to variant records (requires `bcftools` installed and available on `PATH`). - Designed for pipeline use: deterministic input/output files and command-line parameters. - **Bulk downloads** - Supports obtaining ClinVar datasets via FTP for offline indexing/annotation workflows. - Recommended when you need reproducible, high-throughput annotation without repeated API calls.
Files in this package (6)
- SKILL.md 3 KB
- clinvar-database_audit_result_v1.json 12 KB
- references/api_reference.md 1 KB
- references/clinical_significance.md 1 KB
- scripts/annotate.py 2 KB
- scripts/search.py 1 KB
Versions
| Repository | Score | Licence |
|---|---|---|
| This page · aipoch/medical-research-skills | 100 | MIT |
| ekko8600/enzyme_design_harness | 100 | Apache-2.0 |
| google-deepmind/science-skills | 95 | Apache-2.0 |
| mkurman/zorai | 95 | MIT |
Database snapshot: 13.11.2026 · package version 82c34a36b87a (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
- 100alterlab-clinvar
Query NCBI ClinVar via the E-utilities API or FTP for the clinical significance (pathogenicity) of human germline genetic variants, searching by gene, variant, condition, or genomic position and interpreting ACMG/AMP classifications and review-status star ratings. Use when… - 100clinvar-annotation
Guide for annotating ENCODE regulatory variants with ClinVar clinical significance. Use when users need to check if variants in ENCODE peaks have clinical associations, find pathogenic variants in regulatory regions, or assess variant clinical impact. Trigger on: ClinVar,… - 100ncbi-entrez
Query NCBI E-utilities for GenBank sequences, gene info, SNPs, ClinVar variants, and literature links. Use when the user needs nucleotide/protein sequences from GenBank, gene summaries, variant data, or cross-database links. NOT for protein annotations (use UniProt), 3D… - 100gene-database
Query the NCBI Gene database via E-utilities and the NCBI Datasets API; use it when you need to search genes by symbol/ID and retrieve annotations (RefSeq, GO, location, phenotype) for single or batch gene lists. - 95dbsnp-database
Use when you want to look up, map, and search for short genetic variants (SNPs, indels) in NCBI's dbSNP database. Resolves between rsIDs, genomic coordinates in VCF format, and HGVS strings. For an rsID, returns variant type, gene associations, clinical significance, allele… - 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,…