equity-scorer

Compute HEIM diversity and equity metrics from VCF or ancestry CSV files.

1.1k|238|Updated Feb 25, 2026
One-click install
npx skills add https://github.com/ClawBio/ClawBio --skill equity-scorer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: equity-scorer
Source: https://github.com/ClawBio/ClawBio/tree/main/skills/equity-scorer
Command: npx skills add https://github.com/ClawBio/ClawBio --skill equity-scorer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Measure how well a genomic dataset represents global population diversity and detect underrepresentation that can bias downstream analyses, by turning genotype or ancestry files into interpretable equity metrics and visualisations.

Core Features & Use Cases

  • Heterozygosity Analysis: Compute observed and expected heterozygosity per population to assess within-group genetic diversity.
  • Population Differentiation: Calculate pairwise FST and render heatmaps to quantify between-population structure.
  • Dimensionality Reduction & Visuals: Run PCA and produce publication-ready PCA plots, ancestry distribution bars, heterozygosity comparisons, and a HEIM gauge.
  • Composite HEIM Equity Score & Reports: Produce a 0-100 HEIM Equity Score with a reproducible markdown report, figures, CSV tables, and checksums for reproducibility.
  • Use Cases: Evaluate biobank representativeness, compare cohort recruitment strategies, QC cohort ancestry composition before association analyses.

Quick Start

Run the equity-scorer on a VCF or ancestry CSV to compute heterozygosity, pairwise FST, PCA plots, and a HEIM Equity Score with a reproducible markdown report.

Frequently Asked Questions about equity-scorer

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

FAQPage Schema
How do I quantify population representation in a VCF file for genomic diversity analysis?

Quantify population representation in a VCF file by computing observed heterozygosity, pairwise FST, PCA plots, and a composite 0-100 HEIM equity score. The process outputs a reproducible directory with markdown reports, figures, and CSV tables.

What is a HEIM equity score and how does it detect ancestry underrepresentation in biobanks?

A HEIM equity score is a 0-100 composite metric that detects ancestry underrepresentation in biobanks by quantifying heterozygosity, population differentiation, and ancestry distributions. It flags biases that can skew downstream genomic analyses.

Can I use ancestry CSV files instead of multi-sample VCFs for pairwise FST and heterozygosity analysis?

Yes, you can use ancestry CSV files instead of multi-sample VCFs for pairwise FST and heterozygosity analysis. The computation accepts both formats to evaluate cohort ancestry composition and generate PCA visualizations.

What is the best way to compare cohort recruitment strategies using population genetics metrics?

The best way to compare cohort recruitment strategies using population genetics metrics is to calculate pairwise FST, heterozygosity comparisons, and ancestry distributions. This produces publication-ready visuals and a HEIM gauge for equity assessment.

Does equity scoring with Python require external servers for processing multi-sample VCF datasets?

Equity scoring with Python does not require external servers for processing multi-sample VCF datasets. The computation operates locally using standard scientific libraries like numpy, pandas, scikit-learn, and matplotlib.

When should I not use PCA and FST metrics for QC cohort ancestry composition?

You should not use PCA and FST metrics for QC cohort ancestry composition when your input VCF or ancestry CSV files lack clear population labels, as the equity score calculation requires defined groups to compute heterozygosity and between-population structure.