A bioinformatics agent for computing HEIM diversity and equity metrics from genomic data.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install equity-scorer
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install equity-scorer using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Equity Scorer?
The Equity Scorer is a specialized bioinformatics agent designed to quantify representation equity in genomic datasets using the Health Equity Index for Minorities (HEIM) framework. This tool among the Openclaw Skills collection provides researchers with a standard method to measure how well a study or biobank represents global populations. It bridges the gap between raw genomic data and actionable equity insights by automating complex population genetics metrics.
By integrating seamlessly into developer and researcher workflows, this skill helps ensure that association studies and genomic cohorts are evaluated for inclusivity. It provides a technical foundation for addressing diversity gaps in modern precision medicine, offering a transparent and reproducible way to score data representation.
Equity Scorer Use Cases
- Assessing the ancestral diversity of a clinical cohort using VCF or CSV inputs
- Benchmarking biobank representation against global population proportions
- Generating publication-ready PCA plots and FST heatmaps for diversity reporting
- Quantifying the impact of population underrepresentation on the generalizability of GWAS findings
How Equity Scorer Works
- Input Analysis: The skill scans provided VCF or CSV files to identify genotype fields, sample IDs, and population annotations.
- Metrics Extraction: It parses genotypes to compute observed and expected heterozygosity per population and pairwise fixation indices (FST).
- Dimensionality Reduction: A Principal Component Analysis (PCA) is performed to visualize population clustering and identify ancestry outliers.
- Scoring Engine: The HEIM composite score is calculated using weighted indices for representation, heterozygosity balance, FST coverage, and geographic spread.
- Artifact Generation: The agent compiles a comprehensive report folder containing CSV tables, PNG visualizations, and a summary Markdown file.
Equity Scorer Setup
The Equity Scorer requires Python 3 and several scientific libraries. You can install the necessary dependencies for this entry in the Openclaw Skills directory using the following commands:
uv pip install biopython pandas scikit-learn matplotlib numpy
Equity Scorer Data Schema & Taxonomy
The skill organizes its output into a structured directory named equity_report/ for easy navigation and data retrieval:
| Path | Purpose |
|---|---|
report.md |
The primary analysis document containing tables, figures, and methodology. |
figures/ |
Contains visualization artifacts like pca_plot.png and fst_heatmap.png. |
tables/ |
Raw data in CSV format, including population summaries and the heim_score.json. |
reproducibility/ |
Includes commands.sh and environment.yml to recreate the exact analysis. |
Equity Scorer Advanced Features
- Composite HEIM Scoring: Provides a standardized 0-100 metric to evaluate study equity across multiple factors.
- Reproducibility Suite: Automatically generates checksums and environment exports for every analysis run to ensure scientific rigor.
- Visual Analytics: Produces high-resolution ancestry bar charts and heterozygosity comparison plots.
- Performance Awareness: Includes safety checks and optimization suggestions for large-scale VCF files exceeding 1GB.
SKILL.md
Loading
Related Openclaw Skills
PharmGx Reporter
A bioinformatics tool for generating detailed pharmacogenomic reports from consumer genetic data to analyze drug response profiles.
Bio Orchestrator
A specialized meta-agent designed to route bioinformatics requests to sub-skills while ensuring data reproducibility and structured reporting.
Equity Scorer
A bioinformatics agent for computing diversity metrics and the HEIM Equity Score from genomic VCF or ancestry data.
django-claw
A secure AI-agent skill for executing Django management commands and ORM queries through a controlled script dispatcher.
NutriGx Advisor
A local AI agent skill for generating science-backed personalised nutrition reports from consumer genetic data.
PharmGx Reporter
A bioinformatics tool that converts raw consumer genetic data into actionable pharmacogenomic reports using CPIC guidelines.
Featured*
