agentleFS
sankar2codesankar2code/Claude-Skill_SubAgent-Builder-Collections/skills/clinical-ai-evaluation-design/SKILL.md

clinical-ai-evaluation-design

Skill2 starsChanged 36 days agoMITView on GitHub

Recommends how to evaluate a clinical predictive AI model, especially after a post-deployment monitoring signal: the immediate governance action, the right escalation pathway, study design, causal estimand, and the causal-inference method for common pitfalls. Based on the lifecycle and signal-to-trial framework in Fosset et al., PLOS Digital Health (2026). Use this skill when the user asks how to evaluate or validate a clinical AI or ML model, what trial design to use for an AI tool, what to do when a deployed model drifts, loses calibration, shows subgroup bias, or when practice or guidelines change, or mentions estimands, stepped-wedge trials, or AI monitoring in healthcare. Part of the Pharma & Clinical pack.

The file

We split this skill into the rules it gives an agent

1 rule. About 0 are common, 1 is distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈1

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Don't invent thresholds. If none exist, recommend that they be pre-specified and suggest how (clinically meaningful change, historical …

    line 110

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Pharma & Clinical pack. Built on a public, peer-reviewed framework. Cite it when you use this skill's recommendations.

Source: Fosset M, Pensier J, Jung B, Siddiqi A, Mamdani M, Celi LA. Clinical predictive artificial intelligence evaluation: A narrative review of trial designs and practical considerations. PLOS Digital Health, 2026. https://doi.org/10.1371/journal.pdig.0001621

Clinical AI Evaluation Design

The framework's central point: performance monitoring, clinical impact monitoring, and scientific evidence generation are different activities, and one can't stand in for another. Good AUROC doesn't show patients benefit, and a stable outcome dashboard doesn't prove the model caused anything. This skill matches each situation to the evidence it actually needs.

Step 1 — Understand the model and the situation

Establish (ask if unclear):

  • The model: what it predicts, who acts on it, and what action follows (alert, triage, dosing suggestion).
  • Lifecycle phase: where it is now (see the table in Step 5).
  • The trigger: a pre-deployment evaluation question, or a monitoring signal after deployment.
  • Thresholds: whether pre-specified alert thresholds exist for performance, outcomes and fairness. If they don't, recommending them is the first finding.
  • Regulatory context: for example, whether a Predetermined Change Control Plan (PCCP) covers model updates.

Step 2 — Classify the monitoring signal

Signal typeWhat it looks like
Clinical outcome alertMeasured patient outcomes get worse in the population using the model
Performance degradationTechnical metrics decline: calibration drift, lower discrimination (AUROC), more false alerts
Fairness violationPerformance gaps appear or widen across subgroups (age, sex, race/ethnicity, site, insurance)
Context shiftSomething external changes the operating environment: new guidelines, practice patterns, case mix, EHR or lab changes

Step 3 — Apply the governance rule first

  • Below the pre-specified threshold: continue surveillance; no escalation. Document the review.
  • Above the threshold: take immediate governance action before any study: pause or roll back the model for the affected subgroup, so standard care resumes. Patient safety comes before evidence generation.

Then follow the escalation cycle: Pause → Evaluate (root-cause the drift) → Update (recalibrate or retrain within the change-control boundaries) → Validate (pre-deployment checks including a fairness audit and silent-mode testing; the paper's example uses 7 days) → Redeploy (with post-update monitoring to confirm recovery).

Step 4 — Choose the escalation pathway

PathwayWhenQuestionDesignEstimand
1. Implementation auditConcern about process fidelity: were the governance procedures followed?Did governance work as intended?Audit of adherence to the pre-defined proceduresNot causal (monitoring)
2. Hybrid dual-primary trialPerformance degradation with possible patient impact: calibration decline, or subgroup performance below safety limitsDoes restoring the model maintain clinical benefit?Stepped-wedge cluster randomized trial with co-primary endpoints(a) Implementation: restoration of model performance, e.g. calibration; (b) Patient outcomes: sustained clinical benefit
3. Effectiveness trialA major failure, or an external context shift that fundamentally changes the clinical environmentDoes the model still deliver patient benefit under the new conditions?Pragmatic randomized controlled trial powered for patient outcomesDirect effect of deployment on clinical endpoints (e.g. mortality, morbidity)

Explain the choice in terms of the user's case, and say what would move it to a higher pathway.

Step 5 — Lifecycle context

PhasePurpose
1. Development and retrospective validationBuild the model and validate it on historical data
2. Feasibility and workflow integrationFit into clinical workflow; usability; silent-mode running
3. Preliminary efficacy and safetySingle-center pilot with adverse-event monitoring
4. Pragmatic randomized trialMulti-center, possibly adaptive, powered for patient outcomes
5. Post-deployment monitoringOngoing surveillance with escalation capability (Steps 2–4)

The paper notes an alternative route: externally validated, stable models may go from Phase 2 straight to Phase 5. If you suggest this, say what evidence justifies skipping the trial phases.

Step 6 — Anticipate the causal-inference traps

ProblemWhy it happensMethod to consider
Time-varying treatment–confounder feedbackThe alert prompts clinician action, which changes the patient's trajectory and the next predictionMarginal structural models with inverse probability weighting
Model version changes mid-studyYou can't observe the same patient under both versions, so version effects mix with secular trendsParametric g-formula, simulating outcomes under each deployment regime
Subgroup and equity questionsToo little power in vulnerable subgroups; site-level variationData fusion: combining trial and observational data
Cross-site transportabilitySingle-site results may not hold under other workflows and populationsTransportability analysis, reweighting to the target site's covariate distribution

Recommend involving a biostatistician or epidemiologist for these methods.

Output: evaluation plan

# Evaluation plan: <model> · <signal or question>
**Signal type:** <…> · **Threshold exceeded:** Yes/No/Not defined
**Immediate governance action:** <continue surveillance / pause for subgroup … / roll back>
**Recommended pathway:** <1/2/3>: <name>
**Why:** <2–3 sentences tied to the case>

## Study design
- Design: <…>
- Primary estimand(s): <…>
- Population / clusters / unit: <…>
- Endpoints: <implementation and/or patient outcomes>
- Key causal-inference risks and methods: <…>

## Governance cycle
Pause → Evaluate → Update → Validate → Redeploy: <specific steps and owners>

## Gaps to close
- <e.g. no pre-specified thresholds; no subgroup monitoring; no PCCP>

**Reference:** Fosset et al., PLOS Digital Health, 2026. doi:10.1371/journal.pdig.0001621

Guardrails

  • This supports study planning; it doesn't replace review by a biostatistician, an ethics committee/IRB, or the organization's clinical governance and regulatory teams.
  • Don't invent thresholds. If none exist, recommend that they be pre-specified and suggest how (clinically meaningful change, historical variation).

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.