defining-cohort-phenotypes

Author computable OMOP cohort definitions with CIRCE-compatible JSON and NLP augmentation.

5.0k|615|Updated Oct 4, 2025
One-click install
npx skills add https://github.com/maziyarpanahi/openmed --skill defining-cohort-phenotypes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: defining-cohort-phenotypes
Source: https://github.com/maziyarpanahi/openmed/tree/main/skills/defining-cohort-phenotypes
Command: npx skills add https://github.com/maziyarpanahi/openmed --skill defining-cohort-phenotypes

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps researchers turn clinical questions into reproducible, computable patient cohort definitions that combine structured OMOP data with signals extracted from clinical text.

Core Features & Use Cases

  • CIRCE Cohort Authoring: Create concept sets, entry events, inclusion rules, and portable cohort expression JSON in the OHDSI ATLAS and CIRCE style.
  • NLP-Augmented Phenotyping: Incorporate OpenMed-extracted diseases, medications, genomics, oncology findings, and social or behavioral features that structured codes may miss.
  • Standards-Based Research: Reuse PheKB and OHDSI Phenotype Library logic, ground entities to standard vocabularies, validate definitions against OMOP CDM data, and document provenance.
  • Use Case: Define an adult diabetes cohort using standard condition concepts while augmenting eligibility with smoking status and symptom findings extracted from clinical notes.

Quick Start

Use this Skill to create a CIRCE-compatible OMOP cohort definition for adults with diabetes, including an NLP-derived smoking-status criterion from clinical notes.

Frequently Asked Questions about defining-cohort-phenotypes

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

FAQPage Schema
How do I build a computable OMOP cohort definition combining structured data and clinical text?

To build a computable OMOP cohort definition, you author concept sets, entry events, and inclusion rules using CIRCE-compatible JSON, then augment eligibility criteria with NLP-derived features extracted locally from clinical notes.

What is a computable phenotype in the OMOP Common Data Model?

A computable phenotype in the OMOP Common Data Model is a reproducible patient cohort definition grounded in standard vocabularies, combining structured codes with clinical NLP signals for validated research eligibility.

How do I create CIRCE cohort expression JSON for OHDSI ATLAS?

You create CIRCE cohort expression JSON for OHDSI ATLAS by defining concept sets, entry events, and inclusion rules that are grounded in standard vocabularies and validated against OMOP CDM data.

Can I reuse logic from PheKB and the OHDSI Phenotype Library for cohort definitions?

Yes, you can reuse PheKB and OHDSI Phenotype Library logic by integrating existing phenotype definitions into new CIRCE-compatible cohort expressions while maintaining standard vocabulary grounding and provenance tracking.

How do I add NLP-derived smoking status to an OMOP diabetes cohort definition?

You add NLP-derived smoking status to an OMOP diabetes cohort by extracting social and behavioral features from clinical notes and incorporating them as custom inclusion rules within the CIRCE cohort expression.

What are the limitations of using CIRCE for NLP-augmented phenotyping?

CIRCE NLP-augmented phenotyping requires local processing of clinical text and standard vocabulary grounding, meaning definitions depend heavily on local NLP extraction quality and provenance documentation for reproducibility.