ukb-navigator

Searches the UK Biobank schema to locate fields and publications by embedding documents in ChromaDB.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

UKB Navigator solves the difficulty researchers face when locating the right UK Biobank data fields, categories, and publications among thousands of entries by providing fast, natural-language semantic search over the UKB schema.

Core Features & Use Cases

  • Semantic field search: Search 12,000+ UKB fields by natural language descriptions and retrieve ranked matches with similarity scores.
  • Category navigation & field lookup: Browse categories (imaging, genomics, health records) and look up specific field IDs (e.g., 21001 = BMI).
  • Publication search & reproducibility: Find related UKB publications and export reproducible reports and CSVs for phenotype definition and cohort construction.

Quick Start

Ask the UKB Navigator to find UK Biobank fields related to blood pressure and save a markdown report to /tmp/ukb_report.

Frequently Asked Questions about ukb-navigator

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

FAQPage Schema
How do I find UK Biobank field IDs using natural language instead of manual schema browsing?

You can search for UK Biobank fields by providing natural language descriptions to match against the data schema. The tool embeds schema documents and returns ranked matches with similarity scores, enabling you to locate specific field IDs without manual browsing.

Can I search UK Biobank categories for imaging, biomarkers, and health records?

Yes, you can search UK Biobank categories for imaging, genomics, and health records. The tool enables category navigation and semantic field lookup, allowing you to explore specific data domains and retrieve relevant field IDs for phenotype definition and cohort construction.

What is the best way to define phenotypes using UK Biobank field-level metadata?

The best way to define phenotypes using UK Biobank field-level metadata is to apply semantic search to locate relevant variables. The tool embeds schema documents into a ChromaDB collection, returning ranked matches with similarity scores to ensure your phenotype definitions are backed by accurate field-level data.

Does the UKB Navigator support reproducible reports and CSV exports for cohort construction?

Yes, UKB Navigator supports reproducible reports and CSV exports for cohort construction. After performing semantic search across the UKB schema, you can generate markdown reports and CSV files documenting your selected fields, categories, and related publications to ensure reproducible research.

Do I need VoyageAI embeddings to search the UK Biobank schema with ChromaDB?

No, you do not strictly need VoyageAI embeddings to search the UK Biobank schema with ChromaDB. The tool embeds schema documents into a ChromaDB collection using VoyageAI or default embedding functions, allowing semantic search to proceed with either embedding method.

Why does semantic search return specific UKB field matches for my descriptive queries?

Semantic search returns specific UKB field matches by embedding schema documents into a ChromaDB collection using VoyageAI or default embedding functions. This vectorizes the 12,000+ UK Biobank field descriptions, allowing the system to calculate similarity scores against your natural language queries and return ranked matches.