dicom-metadata-extract

Extract DICOM header metadata and PHI-presence indicators into structured JSON.

Updated Apr 16, 2026
One-click install
npx skills add https://github.com/sayalinvidia/sayali-skills-test --skill dicom-metadata-extract
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: dicom-metadata-extract
Source: https://github.com/sayalinvidia/sayali-skills-test/tree/main/skills/dicom-metadata-extract
Command: npx skills add https://github.com/sayalinvidia/sayali-skills-test --skill dicom-metadata-extract

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pydicom, typer, and includes scripts (resource) components.

What problem does it solve?

Extract DICOM header metadata and a PHI-presence indicator from a single DICOM file to support engineering workflows that require visibility into sensitive data without performing de-identification.

Core Features & Use Cases

  • Reads DICOM headers and outputs a structured JSON payload including modality, study, series, and image metadata, plus phi_present and phi_tags_found fields.
  • Flags PHI presence based on a standard subset of DICOM PS3.15 basic-profile tags and includes a phi_scope_disclaimer to outline scope and limitations.
  • Use Case: engineers validating PHI handling in non-clinical pipelines or during data release checks.

Quick Start

Run the skill on a DICOM file to produce a JSON payload containing modality, study/series/image metadata, and PHI flags.

Frequently Asked Questions about dicom-metadata-extract

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

FAQPage Schema
How do I extract DICOM metadata and check for PHI presence in a medical imaging file?▼

To extract DICOM metadata and check for PHI presence, this skill uses pydicom to read the file header and returns a structured JSON payload containing modality, study, series, image fields, and a phi_present indicator based on DICOM PS3.15 basic-profile tags.

Does pydicom support identifying Protected Health Information tags in DICOM headers?▼

Yes, pydicom reads the DICOM headers, and this skill flags PHI presence by checking against a standard subset of DICOM PS3.15 basic-profile tags, returning phi_present and phi_tags_found fields for validation.

Can I use this DICOM metadata extraction for clinical data de-identification workflows?▼

No, you cannot use this skill for clinical data de-identification workflows because it explicitly does not perform de-identification; it only extracts metadata and returns a phi_scope_disclaimer outlining the limitations of its PHI detection scope.

What is the best way to validate PHI handling in non-clinical DICOM pipelines?▼

The best way to validate PHI handling in non-clinical DICOM pipelines is to run this skill on a file to produce a JSON payload with phi_present and phi_tags_found fields, enabling engineers to review sensitive data visibility without altering the original file.

What DICOM header fields are included in the JSON metadata extraction output?▼

The JSON metadata extraction output includes modality, study, series, and image metadata fields, alongside the phi_present boolean, phi_tags_found list, and a phi_scope_disclaimer to support engineering testing scenarios.

Why does my DICOM metadata extraction show a phi_scope_disclaimer in the output?▼

A phi_scope_disclaimer appears in the DICOM metadata extraction output to explicitly outline the scope and limitations of the PHI detection mechanism, reminding users that the skill checks a subset of PS3.15 basic-profile tags and does not perform de-identification.