dicom-series-preflight

Analyze DICOM directories and output a header-only preflight JSON report.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

In engineering workflows, teams need a fast, header-only check of a DICOM series directory to detect orientation issues, PHI presence, spacing, and data integrity before downstream processing.

Core Features & Use Cases

  • Header-only preflight validation checks for missing tags, orientation consistency, spacing variations, and PHI tag presence across a DICOM series.
  • Engineering verification preflight provides a structured, gate-ready report to guide downstream processing decisions such as conversion or model inference.
  • Use Case: Before running a segmentation or conversion workflow, run the preflight to surface data quality issues and gating conditions.

Quick Start

Run the preflight against a DICOM directory to emit a structured JSON report.

Frequently Asked Questions about dicom-series-preflight

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

FAQPage Schema
How do I validate DICOM series headers for PHI and orientation before processing?

Run a header-only preflight check on a DICOM directory to validate orientation, spacing, and PHI tags before conversion or model inference, producing a schema-conformant JSON report for downstream processing decisions.

What is a DICOM preflight check and when do I need it?

A DICOM preflight check is a header-only validation step that detects orientation issues, spacing variations, and PHI tags across a directory. It is needed before running segmentation or conversion workflows to surface data quality issues.

Can I check a DICOM directory for PHI tags without loading pixel data?

Yes, you can check a DICOM directory for PHI tags using a header-only preflight validation. This analyzes DICOM metadata to detect PHI tag presence without loading pixel data, ensuring safe sharing and fast verification.

Does the DICOM preflight validation work with Python and pydicom?

Yes, the DICOM preflight validation works with Python 3.10 and above, utilizing pydicom, nibabel, and numpy. It runs via a Python script entrypoint to analyze DICOM series and emit a structured JSON report.

What is the best way to verify DICOM spacing and orientation consistency across files?

The best way to verify DICOM spacing and orientation consistency is to run a preflight validation script that checks headers across all files in a series. This produces a gate-ready JSON report detailing any variations or missing tags.

Why does my DICOM conversion workflow fail due to inconsistent series metadata?

DICOM conversion workflows often fail due to inconsistent orientation, spacing, or missing tags across series files. Running a header-only preflight check identifies these data integrity issues beforehand to prevent downstream processing failures.