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
npx skills add anthropics/healthcare --skill clinical-note-extract-skill -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/clinical-note-extract/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/clinical-note-extract/
1Skills CLI (Vercel)
npx skills add anthropics/healthcare --skill clinical-note-extract-skill -a codex2Manually: put the files in place
.agents/skills/clinical-note-extract/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add anthropics/healthcare --skill clinical-note-extract-skill -a cursor2Manually: put the files in place
.cursor/skills/clinical-note-extract/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install anthropics/healthcare plugins/healthcare/skills/clinical-note-extract2Manually: put the files in place
.github/skills/clinical-note-extract/SKILL.md1Skills CLI (Vercel)
npx skills add anthropics/healthcare --skill clinical-note-extract-skill -a gemini-cli2Platform CLI
gemini skills install https://github.com/anthropics/healthcare --path plugins/healthcare/skills/clinical-note-extractManually: put the files in place
.devin/skills/clinical-note-extract/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add anthropics/healthcare --skill clinical-note-extract-skill -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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.