CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

pydicom

Python library for working with DICOM (Digital Imaging and Communications in Medicine) files. Use this skill when reading, writing, or modifying medical imaging data in DICOM format, extracting pixel data from medical images (CT, MRI, X-ray, ultrasound), anonymizing DICOM files, working with DICOM metadata and tags, converting DICOM images to other formats, handling compressed DICOM data, or processing medical imaging datasets. Applies to tasks involving medical image analysis, PACS systems, radiology workflows, and healthcare imaging applications.

68

Quality

86%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

The canonical home for this skill is pydicom in K-Dense-AI/scientific-agent-skills

SKILL.md
Quality
Evals
Security

Quality

Content

76%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A highly actionable, well-organized skill whose code examples are executable and pydicom-specific throughout, backed by real reference files and helper scripts. The main weaknesses are the missing validation/verification checkpoints in the destructive anonymization and batch series workflows (capping workflow clarity at 3) and moderate redundancy between the description, Overview, and When to Use sections.

Suggestions

Add an explicit validation step to the anonymization workflow, e.g. after saving run 'python scripts/extract_metadata.py output.dcm' to confirm no PHI tags remain, and only then share the file.

Trim the redundant 'Overview' and 'When to Use This Skill' sections (they restate the frontmatter description) and move the long 'Writing DICOM Files' example into a reference file to slim the body.

Include a verification checkpoint in the batch series workflow (e.g., check each read succeeded and slice count matches expected before building the volume).

DimensionReasoningScore

Conciseness

The body is mostly efficient: nearly every section is executable pydicom-specific guidance rather than general concepts. Minor over-explanation could be trimmed — the 'Overview' and 'When to Use This Skill' sections largely restate the frontmatter description, and the 'Writing DICOM Files' example pads out every required element inline. This matches the 4 anchor ('minor instances of over-explanation') better than the 3 anchor, since the padding is limited to a few sections and the bulk of the content earns its tokens.

4 / 5

Actionability

Nearly every workflow ships complete, copy-paste-ready code with correct pydicom APIs ('pydicom.dcmread()', 'ds.pixel_array', 'apply_voi_lut', 'ds.decompress()'), plus runnable helper scripts with exact command lines ('python scripts/anonymize_dicom.py input.dcm output.dcm') and a targeted troubleshooting section. This matches the 5 anchor for fully executable coverage of the common cases.

5 / 5

Workflow Clarity

Sections are clearly organized per task with good sequencing hints, but the destructive and batch operations lack validation checkpoints. The anonymization workflow deletes PHI tags and saves with no verification step (e.g., re-reading the output to confirm tags are gone), and the batch series-processing workflow has no error handling or validation. Per the rubric's explicit guideline, destructive/batch workflows without validation cap workflow clarity at 3 — this takes precedence over the otherwise solid sequencing.

3 / 5

Progressive Disclosure

Structure is good and references are real and one level deep: 'See references/transfer_syntaxes.md for complete list' and the Reference Materials section lists both existing files, and the Helper Scripts section documents all three scripts in scripts/ with usage lines. It sits below the 5 anchor because the ~440-line body inlines many full workflow examples (e.g., the complete write-from-scratch and multi-frame examples) that could partially live in reference files, keeping SKILL.md a leaner overview.

4 / 5

Total

16

/

20

Passed

Description

92%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong, third-person description with an explicit 'Use this skill when' trigger clause and a comprehensive, concrete capability list. Its only notable gap is the absence of the '.dcm' file extension and a few synonymous phrasings that would push trigger term coverage to full marks.

DimensionReasoningScore

Specificity

The description lists many concrete, distinct actions — 'reading, writing, or modifying medical imaging data', 'extracting pixel data', 'anonymizing DICOM files', 'working with DICOM metadata and tags', 'converting DICOM images to other formats', 'handling compressed DICOM data' — giving comprehensive coverage of the library's capabilities. It matches the anchor for multiple specific concrete actions and is not below it, since no significant capability area is omitted.

5 / 5

Completeness

It explicitly answers both questions: what ('Python library for working with DICOM... files') and when ('Use this skill when reading, writing, or modifying...') with concrete trigger phrases. It mirrors the anchor example that pairs a capability list with an explicit 'Use when' clause; the 4 anchor's 'when could be more explicit' does not apply here.

5 / 5

Trigger Term Quality

Strong natural keyword coverage: 'DICOM files', 'CT, MRI, X-ray, ultrasound', 'medical imaging', 'metadata and tags', 'PACS systems', 'radiology workflows'. It falls short of the 5 anchor because it never mentions the '.dcm' file extension or the shorthand 'DICOMs', the terms a user would most naturally type when asking for this skill.

4 / 5

Distinctiveness Conflict Risk

The DICOM/medical-imaging niche is unmistakable — triggers like 'DICOM', 'PACS', 'radiology', 'anonymizing DICOM files' would not plausibly route to another skill. It has a clear niche with distinct triggers and minimal conflict risk, matching the 5 anchor rather than the 4 anchor's 'minor overlap risk with closely related skills'.

5 / 5

Total

19

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

14

/

16

Passed

Repository

synthetic-sciences/openscience

Path

backend/cli/skills/biology/pydicom/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.