pathml
Computational pathology toolkit for analyzing whole-slide images (WSI) and multiparametric imaging data. Use this skill when working with histopathology slides, H&E stained images, multiplex immunofluorescence (CODEX, Vectra), spatial proteomics, nucleus detection/segmentation, tissue graph construc…
Install / Use
npx skills add foryourhealth111-pixel/Vibe-Skills --skill pathmlInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
AutomationSupported Platforms
Our assessment of pathml
pathml scores 92/100 on our quality scale, 786th of 2,790 Automation skills we index (top 29%).
Its SKILL.md is 7.7 KB long, well organised into 24 sections with 2 code examples: a thorough specification that gives an agent plenty to work with.
With 3,433 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 3 months ago, so pathml is actively maintained.
- Our last check on 2026-10-27 found the source still online.
- It is released under the Apache-2.0 license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-02. Automated pattern scan on 2026-10-02. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
pathml compared with similar skills
All 4 of these similar skills score higher than pathml; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| pathml (this skill)by foryourhealth111-pixel | 92 | 3.4k | 3mo ago | SKILL.md |
| taste-skillby Leonxlnx | 100 | 116.8k | 8d ago | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 81.9k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.8k | today | CLAUDE.md |
Frequently asked questions
- How do I install pathml?
- Run
npx skills add foryourhealth111-pixel/Vibe-Skills --skill pathml. The install tabs above show the steps for each supported agent. - Which AI agents does pathml work with?
- It is written for OpenAI Codex, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is pathml safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is Apache-2.0-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is pathml still maintained?
- The repository was last updated about 3 months ago, so pathml is actively maintained.
Skill content
View source on GitHubname: pathml description: Computational pathology toolkit for analyzing whole-slide images (WSI) and multiparametric imaging data. Use this skill when working with histopathology slides, H&E stained images, multiplex immunofluorescence (CODEX, Vectra), spatial proteomics, nucleus detection/segmentation, tissue graph construction, or training ML models on pathology data. Supports 160+ slide formats including Aperio SVS, NDPI, DICOM, OME-TIFF for digital pathology workflows.
PathML
Overview
PathML is a comprehensive Python toolkit for computational pathology workflows, designed to facilitate machine learning and image analysis for whole-slide pathology images. The framework provides modular, composable tools for loading diverse slide formats, preprocessing images, constructing spatial graphs, training deep learning models, and analyzing multiparametric imaging data from technologies like CODEX and multiplex immunofluorescence.
Routing Boundary
Use this skill for full computational pathology workflows, PathML pipelines, WSI analysis, nucleus segmentation, tissue or cell graphs, spatial pathology, multiplex pathology, and multiparametric imaging. Basic WSI tile extraction should stay with histolab, DICOM tag/anonymization work with pydicom, IDC/TCIA/DICOMWeb retrieval with imaging-data-commons, and OMERO server or ROI management with omero-integration.
When to Use This Skill
Apply this skill for:
- Loading and processing whole-slide images (WSI) in various proprietary formats
- Preprocessing H&E stained tissue images with stain normalization
- Nucleus detection, segmentation, and classification workflows
- Building cell and tissue graphs for spatial analysis
- Training or deploying machine learning models (HoVer-Net, HACTNet) on pathology data
- Analyzing multiparametric imaging (CODEX, Vectra, MERFISH) for spatial proteomics
- Quantifying marker expression from multiplex immunofluorescence
- Managing large-scale pathology datasets with HDF5 storage
- Tile-based analysis and stitching operations
Core Capabilities
PathML provides six major capability areas documented in detail within reference files:
1. Image Loading & Formats
Load whole-slide images from 160+ proprietary formats including Aperio SVS, Hamamatsu NDPI, Leica SCN, Zeiss ZVI, DICOM, and OME-TIFF. PathML automatically handles vendor-specific formats and provides unified interfaces for accessing image pyramids, metadata, and regions of interest.
See: references/image_loading.md for supported formats, loading strategies, and working with different slide types.
2. Preprocessing Pipelines
Build modular preprocessing pipelines by composing transforms for image manipulation, quality control, stain normalization, tissue detection, and mask operations. PathML's Pipeline architecture enables reproducible, scalable preprocessing across large datasets.
Key transforms:
StainNormalizationHE- Macenko/Vahadane stain normalizationTissueDetectionHE,NucleusDetectionHE- Tissue/nucleus segmentationMedianBlur,GaussianBlur- Noise reductionLabelArtifactTileHE- Quality control for artifacts
See: references/preprocessing.md for complete transform catalog, pipeline construction, and preprocessing workflows.
3. Graph Construction
Construct spatial graphs representing cellular and tissue-level relationships. Extract features from segmented objects to create graph-based representations suitable for graph neural networks and spatial analysis.
See: references/graphs.md for graph construction methods, feature extraction, and spatial analysis workflows.
4. Machine Learning
Train and deploy deep learning models for nucleus detection, segmentation, and classification. PathML integrates PyTorch with pre-built models (HoVer-Net, HACTNet), custom DataLoaders, and ONNX support for inference.
Key models:
- HoVer-Net - Simultaneous nucleus segmentation and classification
- HACTNet - Hierarchical cell-type classification
See: references/machine_learning.md for model training, evaluation, inference workflows, and working with public datasets.
5. Multiparametric Imaging
Analyze spatial proteomics and gene expression data from CODEX, Vectra, MERFISH, and other multiplex imaging platforms. PathML provides specialized slide classes and transforms for processing multiparametric data, cell segmentation with Mesmer, and quantification workflows.
See: references/multiparametric.md for CODEX/Vectra workflows, cell segmentation, marker quantification, and integration with AnnData.
6. Data Management
Efficiently store and manage large pathology datasets using HDF5 format. PathML handles tiles, masks, metadata, and extracted features in unified storage structures optimized for machine learning workflows.
See: references/data_management.md for HDF5 integration, tile management, dataset organization, and batch processing strategies.
Quick Start
Installation
# Install PathML
uv pip install pathml
# With optional dependencies for all features
uv pip install pathml[all]
Basic Workflow Example
from pathml.core import SlideData
from pathml.preprocessing import Pipeline, StainNormalizationHE, TissueDetectionHE
# Load a whole-slide image
wsi = SlideData.from_slide("path/to/slide.svs")
# Create preprocessing pipeline
pipeline = Pipeline([
TissueDetectionHE(),
StainNormalizationHE(target='normalize', stain_estimation_method='macenko')
])
# Run pipeline
pipeline.run(wsi)
# Access processed tiles
for tile in wsi.tiles:
processed_image = tile.image
tissue_mask = tile.masks['tissue']
Common Workflows
H&E Image Analysis:
- Load WSI with appropriate slide class
- Apply tissue detection and stain normalization
- Perform nucleus detection or train segmentation models
- Extract features and build spatial graphs
- Conduct downstream analysis
Multiparametric Imaging (CODEX):
- Load CODEX slide with
CODEXSlide - Collapse multi-run channel data
- Segment cells using Mesmer model
- Quantify marker expression
- Export to AnnData for single-cell analysis
Training ML Models:
- Prepare dataset with public pathology data
- Create PyTorch DataLoader with PathML datasets
- Train HoVer-Net or custom models
- Evaluate on held-out test sets
- Deploy with ONNX for inference
References to Detailed Documentation
When working on specific tasks, refer to the appropriate reference file for comprehensive information:
- Loading images:
references/image_loading.md - Preprocessing workflows:
references/preprocessing.md - Spatial analysis:
references/graphs.md - Model training:
references/machine_learning.md - CODEX/multiplex IF:
references/multiparametric.md - Data storage:
references/data_management.md
Resources
This skill includes comprehensive reference documentation organized by capability area. Each reference file contains detailed API information, workflow examples, best practices, and troubleshooting guidance for specific PathML functionality.
references/
Documentation files providing in-depth coverage of PathML capabilities:
image_loading.md- Whole-slide image formats, loading strategies, slide classespreprocessing.md- Complete transform catalog, pipeline construction, preprocessing workflowsgraphs.md- Graph construction methods, feature extraction, spatial analysismachine_learning.md- Model architectures, training workflows, evaluation, inferencemultiparametric.md- CODEX, Vectra, multiplex IF analysis, cell segmentation, quantificationdata_management.md- HDF5 storage, tile management, batch processing, dataset organization
Load these references as needed when working on specific computational pathology tasks.
Related Skills
taste-skill
116.8kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
ruflo
81.9k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
79.8kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.