Clarity Clinical Skill
name: clarity-clinical
by clarityprotocol · published 2026-03-22
$ claw add gh:clarityprotocol/clarityprotocol-clarity-clinical---
name: clarity-clinical
description: >
Query clinical variant data from ClinVar and gnomAD via Clarity Protocol.
Use when the user asks about ClinVar classification, clinical significance,
pathogenicity, gnomAD frequency, population genetics, or clinical data for gene.
Capabilities: search clinical variants by gene, get detailed variant annotations.
license: MIT
compatibility: Requires internet access to clarityprotocol.io. Optional CLARITY_API_KEY env var for 100 req/min (vs 10 req/min).
metadata:
author: clarity-protocol
version: "1.0.0"
homepage: https://clarityprotocol.io
---
# Clarity Clinical Skill
Access clinical variant annotations from ClinVar and population frequency data from gnomAD through Clarity Protocol's integrated database.
Quick Start
List all clinical variants:
python scripts/query_clinical.pyFilter by gene symbol:
python scripts/query_clinical.py --gene-symbol MAPTGet details for a specific variant:
python scripts/query_clinical.py --gene MAPT --variant NM_005910.6:c.926C>TGet variant details in readable format:
python scripts/query_clinical.py --gene MAPT --variant NM_005910.6:c.926C>T --format summaryClinical Variant Fields
Each clinical variant includes:
ClinVar Significance Values
gnomAD Frequency Interpretation
Rate Limits
To use an API key, set the `CLARITY_API_KEY` environment variable:
export CLARITY_API_KEY=your_key_here
python scripts/query_clinical.py --gene-symbol MAPTGet your API key at https://clarityprotocol.io
Error Handling
**404 Not Found**: The specified gene/variant combination does not exist in the clinical database.
**429 Rate Limit**: You've exceeded the rate limit. The script will display how long to wait.
**500 Server Error**: The API server encountered an error. Try again later.
**Timeout**: The request took longer than 30 seconds.
Pagination
Clinical variant lists are paginated. The API returns a `next_cursor` field if more results are available.
Use Cases
More tools from the same signal band
Order food/drinks (点餐) on an Android device paired as an OpenClaw node. Uses in-app menu and cart; add goods, view cart, submit order (demo, no real payment).
Sign plugins, rotate agent credentials without losing identity, and publicly attest to plugin behavior with verifiable claims and authenticated transfers.
The philosophical layer for AI agents. Maps behavior to Spinoza's 48 affects, calculates persistence scores, and generates geometric self-reports. Give your...