Clinpgx

• Gene symbol (text): Standard HGNC gene symbols, e.g., CYP2D6, CYP2C19, VKORC1
• Drug name (text): Generic drug names, e.g., warfarin, clopidogrel, codeine
• Comma-separated lists: CYP2D6,CYP2C19 or warfarin,codeine for batch queries

Workflow

When the user asks about a gene or drug in the ClinPGx database:

1. Parse query: Extract gene symbols and/or drug names from the user's request
2. Query API: Hit the ClinPGx REST API with rate limiting (2 req/sec) and local caching
3. Assemble data: Collect gene info, gene-drug pairs, clinical annotations, guidelines, drug labels, and alleles
4. Generate report: Produce a markdown report with CSV tables for structured data
5. Attribute source: Always cite ClinPGx/PharmGKB with CC BY-SA 4.0 license

Example Queries

• "Look up CYP2D6 on ClinPGx"
• "What drugs interact with CYP2C19?"
• "Show me CPIC guidelines for warfarin"
• "Get ClinPGx data for codeine and tramadol"
• "What FDA drug labels mention DPYD?"

Output Structure

output_directory/
├── report.md                    # Full markdown report
└── tables/
    ├── gene_drug_pairs.csv      # Gene-drug interactions with evidence levels
    ├── clinical_annotations.csv # Curated variant-drug-phenotype annotations
    ├── guidelines.csv           # CPIC/DPWG clinical guidelines
    └── alleles.csv              # Known allele definitions

Dependencies

Required:

• requests >= 2.28.0 (HTTP client for API access)

Optional: None

Safety

• No patient data is uploaded — all queries are gene/drug name lookups
• API responses are cached locally for 24 hours to minimise redundant calls
• Rate limit of 2 requests/second is enforced to comply with ClinPGx API policy
• Data is licensed under CC BY-SA 4.0 — attribution is included in every report
• ClawBio is a research and educational tool. It is not a medical device and does not provide clinical diagnoses. Consult a healthcare professional before making any medical decisions.

Integration with Bio Orchestrator

This skill is invoked by the Bio Orchestrator when:

• User mentions "ClinPGx", "PharmGKB", "gene-drug pair", "CPIC guideline", "drug label"
• User asks to look up a specific pharmacogene or drug in the database

It can be chained with:

• pharmgx-reporter: After generating a patient PGx report, query ClinPGx for deeper annotation on flagged gene-drug pairs
• vcf-annotator: Use ClinPGx allele definitions to annotate VCF variants