SkillAgentSearch skills...

bio-flow-cytometry-clustering-phenotyping

Unsupervised clustering and cell type identification for flow/mass cytometry. Covers FlowSOM, Phenograph, and CATALYST workflows

Install / Use

npx skills add FreedomIntelligence/OpenClaw-Medical-Skills --skill bio-flow-cytometry-clustering-phenotyping

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

89/100

Category

Automation

Supported Platforms

Universal

Tags

Our assessment of bio-flow-cytometry-clustering-phenotyping

bio-flow-cytometry-clustering-phenotyping scores 89/100 on our quality scale, 1362nd of 2,780 Automation skills we index (top 49%).

Its SKILL.md is 6.9 KB long, well organised into 42 sections with 11 code examples: a thorough specification that gives an agent plenty to work with.

With 3,034 GitHub stars, it is one of the more widely adopted skills in the catalogue.

Substance
29/30
Structure
20/20
Description
15/15
Adoption
15/20
Freshness
11/15

Maintenance, license and trust

  • The repository was last updated about 4 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
  • Our last check on 2026-10-31 found the source still online.
  • No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
  • Its trust signals score 86/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

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.

AI review by kimi-k2.7-code on 2026-09-29. Automated pattern scan on 2026-09-29. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

bio-flow-cytometry-clustering-phenotyping compared with similar skills

All 4 of these similar skills score higher than bio-flow-cytometry-clustering-phenotyping; compare them before choosing.

SkillScoreStarsUpdatedFormat
bio-flow-cytometry-clustering-phenotyping (this skill)by FreedomIntelligence893.0k4mo agoSKILL.md
Agent-Reachby Panniantong100112.3k8d agoCLAUDE.md
rufloby ruvnet10081.9ktodayCLAUDE.md
Claude-Code-Game-Studiosby Donchitos10039.7k7d agoCLAUDE.md
Scraplingby D4Vinci100103.6k2d agoMCP Server

Frequently asked questions

How do I install bio-flow-cytometry-clustering-phenotyping?
Run npx skills add FreedomIntelligence/OpenClaw-Medical-Skills --skill bio-flow-cytometry-clustering-phenotyping. The install tabs above show the steps for each supported agent.
Which AI agents does bio-flow-cytometry-clustering-phenotyping work with?
It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
Is bio-flow-cytometry-clustering-phenotyping 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 declares no license and scores 86/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 bio-flow-cytometry-clustering-phenotyping still maintained?
The repository was last updated about 4 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.

name: bio-flow-cytometry-clustering-phenotyping description: Unsupervised clustering and cell type identification for flow/mass cytometry. Covers FlowSOM, Phenograph, and CATALYST workflows. Use when discovering cell populations in high-dimensional cytometry data without predefined gates. tool_type: r primary_tool: CATALYST

Version Compatibility

Reference examples tested with: FlowSOM 2.10+, scanpy 1.10+

Before using code patterns, verify installed versions match. If versions differ:

  • R: packageVersion('<pkg>') then ?function_name to verify parameters

If code throws ImportError, AttributeError, or TypeError, introspect the installed package and adapt the example to match the actual API rather than retrying.

Clustering and Phenotyping

"Cluster my cytometry data to find cell types" → Discover cell populations in high-dimensional flow/mass cytometry data using unsupervised clustering without predefined gates.

  • R: FlowSOM::FlowSOM() for self-organizing map clustering
  • R: CATALYST::cluster() with Phenograph or FlowSOM

FlowSOM Clustering

Goal: Cluster cytometry events into cell populations using self-organizing maps.

Approach: Build a FlowSOM grid on marker channels, then extract metacluster assignments per cell.

library(FlowSOM)

# Prepare data
expr <- exprs(fcs)
marker_cols <- grep('CD|HLA', colnames(fcs), value = TRUE)

# Build SOM
fsom <- FlowSOM(fcs,
                colsToUse = marker_cols,
                xdim = 10, ydim = 10,
                nClus = 20,
                seed = 42)

# Get cluster assignments
clusters <- GetMetaclusters(fsom)

# Add to flowFrame
exprs(fcs) <- cbind(exprs(fcs), cluster = clusters)

CATALYST Workflow (Full Pipeline)

Goal: Run the complete CATALYST clustering pipeline from flowSet to annotated cell populations.

Approach: Convert flowSet to SingleCellExperiment with prepData, then cluster on type markers with FlowSOM via CATALYST.

library(CATALYST)
library(SingleCellExperiment)

# Create SCE from flowSet
sce <- prepData(fs, panel, md, transform = TRUE, cofactor = 5)

# Clustering
sce <- cluster(sce,
               features = 'type',  # Use 'type' markers from panel
               xdim = 10, ydim = 10,
               maxK = 20,
               seed = 42)

# View cluster assignments
table(cluster_ids(sce, 'meta20'))

Phenograph Clustering

Goal: Identify cell populations using graph-based community detection on marker expression.

Approach: Build a k-nearest-neighbor graph on type markers, then partition with Louvain community detection via Rphenograph.

library(Rphenograph)

# Extract expression matrix
expr <- assay(sce, 'exprs')

# Run Phenograph
pheno_result <- Rphenograph(t(expr[rowData(sce)$marker_class == 'type', ]), k = 30)

# Get clusters
sce$phenograph <- factor(membership(pheno_result[[2]]))

Dimensionality Reduction

Goal: Project high-dimensional cytometry data into 2D for visualization of cell populations.

Approach: Run UMAP or tSNE on type marker channels using CATALYST's runDR wrapper, then plot colored by cluster.

# UMAP
sce <- runDR(sce, dr = 'UMAP', features = 'type')

# tSNE
sce <- runDR(sce, dr = 'TSNE', features = 'type')

# Plot
plotDR(sce, 'UMAP', color_by = 'meta20')

Cluster Annotation

Goal: Assign cell type labels to clusters based on marker expression profiles.

Approach: Visualize median marker expression per cluster with a heatmap, then map cluster IDs to cell type names.

# Heatmap of marker expression by cluster
plotExprHeatmap(sce, features = 'type',
                by = 'cluster_id', k = 'meta20',
                scale = 'first', row_anno = FALSE)

# Manual annotation
cluster_annotation <- c(
    '1' = 'CD4 T cells',
    '2' = 'CD8 T cells',
    '3' = 'B cells',
    '4' = 'NK cells',
    '5' = 'Monocytes'
)

sce$cell_type <- cluster_annotation[as.character(cluster_ids(sce, 'meta20'))]

Cluster Merging

Goal: Reduce overclustering by merging similar clusters into biologically meaningful groups.

Approach: Define a mapping table from original to merged cluster IDs, then apply with CATALYST's mergeClusters.

# Merge similar clusters
merging_table <- data.frame(
    original = 1:20,
    merged = c(1, 1, 2, 2, 3, 3, 4, 4, 5, 5,
               6, 6, 7, 7, 8, 8, 9, 9, 10, 10)
)

sce <- mergeClusters(sce, k = 'meta20', table = merging_table, id = 'merged')

Abundance Analysis (per sample)

Goal: Quantify the relative frequency of each cell population across samples and conditions.

Approach: Cross-tabulate cluster assignments by sample ID, convert to proportions, and plot grouped by condition.

# Cluster frequencies per sample
abundances <- table(cluster_ids(sce, 'meta20'), sce$sample_id)
freq <- prop.table(abundances, margin = 2)

# Plot
plotAbundances(sce, k = 'meta20', by = 'cluster_id', group_by = 'condition')

Marker Expression Summary

Goal: Summarize and compare marker expression levels across clusters and conditions.

Approach: Plot per-cluster median expression with CATALYST's plotClusterExprs and pseudo-bulk expression faceted by cluster.

# Median expression per cluster
plotClusterExprs(sce, k = 'meta20', features = 'type')

# Expression by cluster and condition
plotPbExprs(sce, k = 'meta20', features = 'type', facet_by = 'cluster_id')

Export Results

Goal: Save clustering results and annotated SCE object for downstream analysis or sharing.

Approach: Extract cluster assignments into colData, export as CSV, and serialize the full SCE as RDS.

# Add cluster info to metadata
colData(sce)$cluster <- cluster_ids(sce, 'meta20')

# Export to CSV
results <- as.data.frame(colData(sce))
write.csv(results, 'clustering_results.csv', row.names = FALSE)

# Save SCE
saveRDS(sce, 'sce_clustered.rds')

Choosing Number of Clusters

Goal: Determine the optimal number of metaclusters for the dataset.

Approach: Compare normalized reduction stability (NRS) plots and heatmaps at different K values to find where clusters remain distinct.

# Delta area plot
plotNRS(sce, features = 'type')

# Or visual inspection of heatmap at different K
plotExprHeatmap(sce, features = 'type', by = 'cluster_id', k = 'meta10')
plotExprHeatmap(sce, features = 'type', by = 'cluster_id', k = 'meta20')

Batch Integration

Goal: Remove batch effects from cytometry data before or after clustering.

Approach: Detect batch effects by coloring UMAP by batch variable, then apply MNN correction with batchelor if needed.

# If batch effects present
library(batchelor)

sce <- runDR(sce, dr = 'UMAP', features = 'type')

# Check for batch effects
plotDR(sce, 'UMAP', color_by = 'batch')

# MNN correction if needed
sce_corrected <- fastMNN(sce, batch = sce$batch)

Related Skills

  • gating-analysis - Manual alternative
  • differential-analysis - Compare clusters between conditions
  • single-cell/clustering - Similar concepts for scRNA-seq

Related Skills

View on GitHub
GitHub Stars3.0k
CategoryAutomation
Updated3mo ago
Forks413

Languages

Python

Trust signals

86/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

1 medium1 info