marker-dominance-mapper

Assigns tissue-region labels to spot-level marker count CSVs by dominant marker expression.

1.1k|257|Updated Feb 25, 2026
One-click install
npx skills add https://github.com/ClawBio/ClawBio --skill marker-dominance-mapper
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: marker-dominance-mapper
Source: https://github.com/ClawBio/ClawBio/tree/main/skills/marker-dominance-mapper
Command: npx skills add https://github.com/ClawBio/ClawBio --skill marker-dominance-mapper

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manually inspecting marker columns spot by spot to assign tissue regions is slow and error-prone. This Skill deterministically maps each spot in a local CSV to a region label (immune_edge, tumor_core, stromal_zone, proliferative_core) based on the dominant marker among EPCAM, PTPRC, COL1A1, and MKI67, then produces a report, tables, and an SVG map.

Core Features & Use Cases

  • Deterministic region assignment: Maps each spot to a region using the highest of four marker counts, with no external APIs or uploads.
  • Hotspot flagging: Flags tumor-core and MKI67-dominant proliferative-core spots for review.
  • Structured outputs: Writes report.md, result.json, mapped_spots.csv, region_summary.csv, an SVG spot map, and a reproducibility command log.
  • Use Case: A researcher with a spot-level marker count table runs the demo or their own CSV to get a labeled region map and summary tables for downstream figure integration.

Quick Start

Run the marker dominance mapper on your spot-count CSV by asking the agent to map marker-dominance spots from your file, or use the built-in demo mode to see a synthetic six-spot region map.

Frequently Asked Questions about marker-dominance-mapper

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

FAQPage Schema
How do I map marker-dominance regions from a spot count CSV?

Run the marker dominance mapper script with --input pointing to your CSV and --output for the result directory. The CSV must contain spot_id, x, y, total_counts, EPCAM, PTPRC, COL1A1, and MKI67 columns, and each spot is labeled by its highest marker.

What input format does marker dominance mapping require?

A CSV file with the columns spot_id, x, y, total_counts, EPCAM, PTPRC, COL1A1, and MKI67. All columns except spot_id must be numeric, and the file must contain at least one spot row.

Does marker dominance mapping need external Python packages?

No, it uses only the Python 3.10+ standard library. There are no third-party package dependencies, and all processing runs locally without network access.

Can this tool do spatial neighbor analysis or clustering?

No, it only assigns regions by dominant marker expression. The x and y coordinates are used solely to draw the SVG map, not for spatial-neighbour analysis, autocorrelation, clustering, or label transfer.

Why does the mapper reject my CSV file?

The script raises an error if required columns are missing, if any required column contains non-numeric values, or if the file has no spot rows. Check that all eight required columns exist and contain valid numbers.