tiledbvcf

Ingest indexed single-sample VCF/BCF files into a TileDB sparse-array dataset for region- and sample-scoped queries.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/gabrielvuksani/wotann --skill tiledbvcf-gabrielvuksani
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tiledbvcf
Source: https://github.com/gabrielvuksani/wotann/tree/main/skills/scientific/tiledbvcf
Command: npx skills add https://github.com/gabrielvuksani/wotann --skill tiledbvcf-gabrielvuksani

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

TileDB-VCF helps you efficiently store and retrieve genomic variant-call data (VCF/BCF) so you can run fast region- and sample-specific queries without costly re-merging or slow filesystem-style access.

Core Features & Use Cases

  • Scalable ingestion with incremental sample addition: Ingest single-sample indexed VCF/BCF files and add new samples later without expensive rebuilding.
  • High-performance sparse-array querying: Query by genomic regions and sample subsets while selecting specific attributes (e.g., genotypes and positions) for cohort-scale analysis.
  • Interoperable export for downstream pipelines: Export selected regions and samples back to VCF format or tabular outputs for sharing, QC, and analysis workflows.

Use case: you have a cohort of single-sample, indexed VCFs and need to repeatedly query variants in specific genomic windows across many samples, then export those subsets for association testing or QC.

Quick Start

Use the tiledbvcf skill to create a dataset from indexed single-sample VCF files and query a region across selected samples, for example: "Create a TileDB-VCF dataset at my_dataset, ingest sample1.vcf.gz and sample2.vcf.gz, then read chr1:1000000-2000000 for sample1 and sample2 with the attributes sample_name, pos_start, pos_end, alleles, and fmt_GT."

Frequently Asked Questions about tiledbvcf

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

FAQPage Schema
How do I store and query VCF files for cohort studies without slow filesystem access?

You can store and query VCF files for cohort studies efficiently by ingesting indexed single-sample VCF/BCF files into a TileDB sparse-array dataset, enabling rapid region- and sample-scoped reads without costly re-merging. This allows high-throughput querying across many samples.

What is the best way to add new genomic samples to an existing variant dataset?

Adding new genomic samples to an existing variant dataset is handled through incremental ingestion. You ingest single-sample indexed VCF/BCF files and add new samples later without expensive rebuilding, supporting iterative sample expansion for population genomics workflows.

How do I extract specific genomic regions and attributes from a VCF cohort?

To extract specific genomic regions and attributes from a VCF cohort, query the TileDB sparse-array dataset by genomic windows and sample subsets while selecting specific attributes like genotypes and positions, then export selected regions back to VCF or tabular outputs.

Do I need indexed VCF files to ingest genomic variant data into a sparse array?

Yes, you need correctly indexed VCF/BCF files (.csi or .tbi) to ingest genomic variant data into a sparse array. The ingestion process requires single-sample VCF inputs and supports parallel ingestion and compressed storage for high-throughput querying.

Can I export queried variant subsets back to VCF format for downstream analysis?

Yes, you can export queried variant subsets back to VCF format or tabular outputs. This interoperable export capability supports sharing, QC, and downstream analysis workflows like association testing after selecting specific regions and samples.

Why does querying large VCF datasets require a sparse-array storage model?

Querying large VCF datasets requires a sparse-array storage model to enable high-performance region- and sample-specific queries. This approach avoids slow filesystem-style access and costly re-merging, applying compressed storage and flexible attribute selection for cohort-scale analysis.