auditing-subgroup-fairness

Audit demographic subgroup leakage and recall in clinical NER models.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill identifies demographic subgroups that receive weaker clinical NER or de-identification performance, helping prevent under-protection and hidden fairness failures that aggregate metrics can miss.

Core Features & Use Cases

  • Subgroup Leakage Analysis: Measures PHI leakage and recall for synthetic demographic groups such as sex, age band, and race or ethnicity when available.
  • Disparity Detection: Calculates leakage disparity, identifies the worst-performing group, and reports span counts and character totals for context.
  • Governance Documentation: Produces JSON-ready fairness results for model cards, clinical AI reviews, and documentation of missing subgroup data.
  • Use Case: Audit an OpenMed de-identification model before deployment to determine whether any synthetic demographic group has higher PHI leakage than the others.

Quick Start

Use the auditing-subgroup-fairness skill to run openmed.eval.fairness_report on a group-tagged gold corpus and summarize per-group recall, leakage, disparity, and data gaps.

Frequently Asked Questions about auditing-subgroup-fairness

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

FAQPage Schema
How do I audit clinical NLP models for demographic subgroup bias?

To audit clinical NLP models for demographic subgroup bias, apply the audit to OpenMed models using group-tagged synthetic fixtures across sex, age bands, and race or ethnicity surrogates to identify disproportionate leakage or recall failures.

What is subgroup leakage analysis in de-identification models?

Subgroup leakage analysis in de-identification models measures PHI leakage and recall for synthetic demographic groups such as sex, age band, and race or ethnicity, revealing hidden fairness failures that aggregate metrics often miss.

How do I detect recall disparity across demographic groups in clinical NER?

Detect recall disparity in clinical NER by running an audit that calculates per-group leakage disparity, identifies the worst-performing demographic group, and reports span counts and character totals for context.

Can I generate model card fairness reports for clinical AI governance reviews?

You can generate model card fairness reports for clinical AI governance reviews by producing JSON-ready fairness results that document per-group leakage, recall, disparity, worst-group performance, and missing subgroup coverage.

What data is needed to run a subgroup fairness audit on OpenMed models?

Running a subgroup fairness audit on OpenMed models requires a group-tagged gold corpus and uses the openmed.eval.fairness_report module to summarize per-group recall, leakage, disparity, and data gaps.

Why does aggregate de-identification performance hide subgroup fairness failures?

Aggregate de-identification performance hides subgroup fairness failures because overall metrics mask weaker clinical NER performance and higher PHI leakage experienced by specific demographic subgroups, requiring targeted disparity detection.