Skip to main content
skill CX Codex official · Anthropic

clinical-note-extract-skill — Claude Code skill

The clinical-note-extract-skill skill extracts structured data from medical text with citations for each value and explicit markers for missing fields. Use it to build registries, check trial eligibility, and flag information gaps.

no license 127 installs ★ 456 updated 2026-08-27

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add anthropics/healthcare --skill clinical-note-extract-skill -a claude-code
Open on GitHub

What clinical-note-extract-skill does

The skill transforms unstructured clinical notes into structured records against a schema you define. Each value carries a citation from the source text, plus metadata about presence, temporality, and null reasons.

The workflow has four steps: you define a schema with field descriptions and validation rules, the skill extracts data from one or many notes in an isolated, tool-free mode, then runs deterministic validation—checking citations against the source and coding values against terminologies (SNOMED, LOINC, or others if you specify them), and finally produces a report showing which fields were populated, which are absent, and which failed checks.

For larger note sets, use the built-in batch.ts script, which processes files locally without sending clinical data to the API. Output records can export to FHIR resources (Condition, FamilyMemberHistory)—the mapping is deterministic and requires no model inference.

What it helps with

  • extract structured clinical data with source citations
  • build a patient registry from unstructured notes
  • screen patients against trial inclusion criteria
  • code clinical findings to SNOMED or LOINC
  • convert flat records to FHIR resources

Example prompts for the agent

  • Pull age, diagnosis, and current medications from this note with paragraph citations
  • Build a registry from 50 notes: patient ID, birthdate, complications, smoking status
  • Find patients for a study: age 18–65, type 2 diabetes, no chronic kidney disease

How to install clinical-note-extract-skill

1Skills CLI (Vercel)

npx skills add anthropics/healthcare --skill clinical-note-extract-skill -a claude-code

2Manually: put the files in place

~/.claude/skills/clinical-note-extract/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/clinical-note-extract/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about clinical-note-extract-skill

How do I install clinical-note-extract-skill in Claude Code?

Run npx skills add anthropics/healthcare --skill clinical-note-extract-skill -a claude-code, then open ~/.claude/skills/clinical-note-extract/SKILL.md to verify. If that name doesn't work, try npx skills add anthropics/healthcare --skill clinical-note-extract -a claude-code (alternate alias).

What does clinical-note-extract-skill do?

It extracts data you specify from clinical notes, preserving citations and recording whether each fact is present or absent, current or historical, and about the patient or a family member. After extraction, the skill validates citations and codes values against medical terminologies if you request it.

What do I need to get started?

Clinical notes (as text, files, or a FHIR connection) and a clear description of which fields to extract. If you want results coded to SNOMED, LOINC, or other standards, you'll need connectors to those terminology services; without them, fields stay unvalidated but extraction still works.

Similar skills

All skills for AI and ML →

From the same set9

fhir-developer-skill fhir-developer-skill guides FHIR R4 API development across healthcare endpoints: handles resource validation, OperationOutcome errors, standard status codes, and coding systems. CX Codex +1 692installs clinical-trial-protocol-skill Builds clinical trial protocols for medical devices and drugs. It helps research prior studies and draft study sections for FDA submissions. CX Codex +1 469installs prior-auth-review-skill prior-auth-review-skill is a Claude Code skill that reviews prior authorization requests against coverage rules. It activates for clinical document processing and medical necessity assessments. CX Codex +1 357installs icd10-cm-skill icd10-cm-skill extracts billable ICD-10-CM diagnosis codes from clinical notes following outpatient claim standards. Designed for billing review and chart coding. CX Codex +1 135installs contracts contracts is a Claude Code skill that answers questions across local contract files with verified citations. It parses clauses and inspects amendments. CX Codex +1 116installs fhir This Claude Code skill connects to FHIR R4 servers and extracts structured findings from patient records. It activates for requests to access a live EHR or retrieve clinical notes. CX Codex +1 111installs doc-extract The doc-extract skill for Claude Code extracts plain text from binary document formats without writing files to disk. The agent invokes it when turning contracts or EHR attachments into text. CX Codex +1 110installs fraud-detection The fraud-detection Claude Code skill screens Medicare and Medicaid claims for signs of fraud, waste, and abuse. It runs on requests to scan a claims dataset or spot billing anomalies. CX Codex +1 104installs

Project sponsors

Companies that keep this analytics open