ingesting-clinical-documents

Converts clinical scans, tables, and CDA XML into privacy-ready text for downstream analysis.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill converts scanned clinical notes, photographed documents, CSV or TSV exports, and C-CDA XML into normalized text suitable for privacy-preserving downstream analysis, without sending patient data to external services.

Core Features & Use Cases

  • On-Device OCR: Extract text and word-level source locations from clinical images using Tesseract or PaddleOCR.
  • Format-Aware Intake: Process image files, structured tables, and C-CDA XML through a unified ExtractedDocument contract.
  • Tabular Redaction: Classify columns as direct identifiers, quasi-identifiers, or safe fields, then apply masking, hashing, dropping, date shifting, or free-text redaction.
  • Source Mapping: Map detected text spans back to source pages and image bounding boxes for pixel-level review or redaction.
  • Use Case: Convert a scanned fax or patient CSV export into clean, PHI-reduced text before running OpenMed de-identification and clinical entity extraction.

Quick Start

Use the ingesting-clinical-documents skill to OCR the attached clinical scan or redact the supplied CSV while preserving source locations and preparing the result for OpenMed analysis.

Frequently Asked Questions about ingesting-clinical-documents

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

FAQPage Schema
How do I OCR scanned clinical documents while preserving layout for PHI redaction?

You can OCR scanned clinical documents using Tesseract or PaddleOCR to extract text and word-level source locations. This process preserves layout and maps detected text spans back to source pages and image bounding boxes for pixel-level review before de-identification.

What is the best way to redact direct identifiers from CSV or TSV clinical exports?

The best way to redact direct identifiers from CSV or TSV exports is to classify columns as direct identifiers, quasi-identifiers, or safe fields, then apply masking, hashing, dropping, date shifting, or free-text redaction to ensure privacy-ready text.

Can I convert C-CDA XML into normalized text for downstream clinical analysis?

Yes, you can convert C-CDA XML into normalized text through CDA flattening. This process transforms structured clinical documents into privacy-ready text suitable for downstream analysis without sending patient data to external services.

Do I need to convert unsupported PDF files to images before processing clinical documents?

Yes, you need to convert unsupported PDF and DOCX files to images first. The OCR intake process requires image files to extract text using Tesseract or PaddleOCR backend for clinical document processing.

Does on-device AI clinical document processing work without sending patient data to external services?

Yes, on-device AI clinical document processing works entirely without external services. Tesseract or PaddleOCR handle OCR locally, and the OpenMed multimodal extra enables privacy-preserving de-identification and entity extraction on-device.

When should I use column-aware redaction instead of free-text redaction for clinical data?

Use column-aware redaction when processing structured CSV or TSV exports, classifying columns as direct identifiers, quasi-identifiers, or safe fields. Apply free-text redaction when dealing with unstructured clinical text or notes containing embedded PHI.