clinvar-database

clinvar-database is a skill for Claude Code, Codex from synthetic-sciences/openscience. It costs 45 tokens per session (3,156 once invoked), scanned A, original, Apache-2.0.

A programming guide to ClinVar, an NCBI archive that collects reports about genetic variants and their links to health conditions. It includes classifications such as pathogenic, benign, and uncertain significance.

In plain words
What is it for?
Use it to search variants by gene, position, or condition, review clinical significance and review status, resolve conflicting interpretations, and annotate VCF files.
Why use it?
It helps compare clinical interpretations and evidence for variants without gathering reports from many separate sources.

Skill for Claude CodeCodex

About the project

synthetic-sciences/openscience is an AI workbench that carries out scientific research by reading papers, forming hypotheses, writing and running code, conducting experiments, analyzing results, and preparing reports. Researchers use it for work in machine learning, biology, physics, and chemistry with remote or local models. Catalogue add-ons extend its scientific workflows through skills and instructions.

synthetic-sciences/openscience · 3,473 stars · on GitHub

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/synthetic-sciences/openscience/clinvar-database
Any agent
npx skills add synthetic-sciences/openscience --skill clinvar-database
Clone the repo
git clone --depth 1 https://github.com/synthetic-sciences/openscience

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for clinvar-database

README.md
[![agentmods](https://agentmods.dev/badge/skills/synthetic-sciences/openscience/clinvar-database.svg)](https://agentmods.dev/skills/synthetic-sciences/openscience/clinvar-database)
Your own site
<a href="https://agentmods.dev/skills/synthetic-sciences/openscience/clinvar-database"><img src="https://agentmods.dev/badge/skills/synthetic-sciences/openscience/clinvar-database.svg" alt="Measured on agentmods" height="20"></a>
Per session 45 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 3,156 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00045 $0.03156
Opus 5 $0.00023 $0.01578
Sonnet 5 $0.00009 $0.00631
Haiku 4.5 $0.00005 $0.00316

Measured yesterday against content hash eee35b0a2435, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

clinvar-database scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

**Quick example using curl:**
Origin

Copies of this mod

8 near-identical copies found in the catalogue:

backend/cli/skills/databases/clinvar-database/SKILL.md · 362 lines

How it starts

The opening of the file, as written. The whole thing — 362 lines — stays where its author put it; the contents beside it link to each section on GitHub.

ClinVar Database

Overview

ClinVar is NCBI's freely accessible archive of reports on relationships between human genetic variants and phenotypes, with supporting evidence. The database aggregates information about genomic variation and its relationship to human health, providing standardized variant classifications used in clinical genetics and research.

When to Use This Skill

This skill should be used when:

  • Searching for variants by gene, condition, or clinical significance
  • Interpreting clinical significance classifications (pathogenic, benign, VUS)
  • Accessing ClinVar data programmatically via E-utilities API
  • Downloading and processing bulk data from FTP
  • Understanding review status and star ratings
  • Resolving conflicting variant interpretations
  • Annotating variant call sets with clinical significance

Core Capabilities

1. Search and Query ClinVar

Web Interface Queries

Search ClinVar using the web interface at https://www.ncbi.nlm.nih.gov/clinvar/

Common search patterns:

  • By gene: BRCA1[gene]
  • By clinical significance: pathogenic[CLNSIG]
  • By condition: breast cancer[disorder]
  • By variant: NM_000059.3:c.1310_1313del[variant name]
  • By chromosome: 13[chr]
  • Combined: BRCA1[gene] AND pathogenic[CLNSIG]
Programmatic Access via E-utilities

Access ClinVar programmatically using NCBI's E-utilities API. Refer to references/api_reference.md for comprehensive API documentation including:

  • esearch - Search for variants matching criteria
  • esummary - Retrieve variant summaries
  • efetch - Download full XML records
  • elink - Find related records in other NCBI databases

Quick example using curl:

# Search for pathogenic BRCA1 variants
curl "https://eutils.ncbi.nlm.nih.gov/entrez/eutils/esearch.fcgi?db=clinvar&term=BRCA1[gene]+AND+pathogenic[CLNSIG]&retmode=json"

Best practices:

  • Test queries on the web interface before automating
  • Use API keys to increase rate limits from 3 to 10 requests/second
  • Implement exponential backoff for rate limit errors
  • Set Entrez.email when using Biopython

Read the full file on GitHub · 362 lines

Files

What ships with it

3 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 362 lines · 45 tokens per session scan A eee35b0a2435

Subscribe to this mod's changes

clinvar-database is a skill published in the GitHub repository synthetic-sciences/openscience (3,473 stars, last pushed today), licensed Apache-2.0. It adds 45 tokens to every session and 3,156 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.

Related

Other skills, from other repositories

meta-paper-write

Use this meta-skill instead of answering directly when the current user asks to draft or produce a new academic/research paper or LaTeX manuscript. It uses multi-skill orchestration for manuscript workflows that need source search, citation planning, experiment or figure/table placeholders, drafting, length checks…

opensquilla/opensquilla · 125 tokens

paper-revision-author

Revise independently drafted paper sections into one coherent LaTeX body before the abstract is written.

opensquilla/opensquilla · 24 tokens

paper-section-author

Write one publication-style research-paper section as a bounded, citation-grounded LaTeX fragment from a writing plan, outline, citation plan, and optional figure/table context.

opensquilla/opensquilla · 38 tokens

meta-arxiv-daily-digest-deck

Fetch the day's top arXiv submissions in a chosen category, write a structured per-paper digest, render the digest as a PPTX deck (one slide per paper), and persist the digest to long-term memory. Use for a daily 'arxiv morning briefing' — manual fire or cron-scheduled.

opensquilla/opensquilla · 71 tokens

paper-quality-gate

Deterministic pre-compile gate for meta-paper-write. Enforces length/citation verdicts and rejects unsupported empirical-result claims when no user evidence was supplied.

opensquilla/opensquilla · 37 tokens

paper-latex-sanitizer

Deterministically normalize safe LaTeX punctuation and replace unsupported forecast magnitudes with explicit placeholders before meta-paper-write publication gates run.

opensquilla/opensquilla · 33 tokens