benchmarking-clinical-ner

Score clinical NER predictions against a gold corpus for span-level precision, recall, and F1.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill evaluates clinical and biomedical named entity recognition models against a user-supplied gold corpus, revealing whether predictions are accurate and where entity boundaries, labels, precision, or recall fail.

Core Features & Use Cases

  • Entity-Level Scoring: Calculate strict exact-span and relaxed overlapping-span precision, recall, and F1 scores.
  • Detailed Error Analysis: Break results down by label and generate confusion matrices, false-negative examples, false-positive examples, and label-confusion reports without retaining plaintext PHI.
  • Flexible Corpus Support: Work with OpenMed fixture files converted from formats such as CoNLL/BIO or BRAT, including documented handling for label normalization, nested spans, class imbalance, and restricted datasets.
  • Use Case: Compare an OpenMed disease-detection model against a licensed clinical gold corpus to determine whether poor performance comes from missed entities, spurious predictions, incorrect labels, or boundary mismatches.

Quick Start

Use the benchmarking clinical NER skill to score the specified OpenMed model against my gold fixture corpus and report strict and relaxed span F1 with per-label error analysis.

Frequently Asked Questions about benchmarking-clinical-ner

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

FAQPage Schema
How do I evaluate clinical NER model accuracy against a gold corpus?

To evaluate clinical NER model accuracy, you score predictions against character-offset gold spans to calculate span-level precision, recall, and F1, applying strict exact-span or relaxed overlapping-span boundary assessment.

How does span matching work for biomedical NLP entity evaluation?

Span matching for biomedical NLP entity evaluation compares predicted character offsets against gold annotations, using strict exact-match boundaries or relaxed overlapping boundaries to quantify precision, recall, and F1 scores.

Can I generate a confusion matrix for clinical named entity recognition predictions?

Yes, you can generate a confusion matrix for clinical named entity recognition predictions, alongside per-label diagnostics, false-positive examples, and false-negative examples, while maintaining privacy-preserving error reporting without retaining plaintext PHI.

Does the evaluation harness support CoNLL or BRAT format gold corpora?

Yes, the evaluation harness supports OpenMed fixture files converted from formats such as CoNLL/BIO or BRAT, including documented handling for label normalization, nested spans, class imbalance, and restricted datasets.

Why does my biomedical NER model have low F1 score on clinical texts?

Low F1 scores in biomedical NER models often stem from missed entities, spurious predictions, incorrect labels, or boundary mismatches, which you can diagnose by breaking down results by label and analyzing false positives and negatives.

What's the best way to diagnose clinical NER boundary mismatches?

To diagnose clinical NER boundary mismatches, apply both strict exact-span and relaxed overlapping-span scoring to isolate whether poor performance comes from incorrect boundaries, spurious predictions, or entirely missed entities.