Home / cuhk-aim-group / neurodiscovery · skills/harmonization-tool/SKILL.md · GitHub

harmonization-tool skillA

harmonization-tool is agent-read markdown (skill) from cuhk-aim-group/neurodiscovery: Use this skill whenever the user wants to remove site/scanner/batch effects from neuroimaging features before running downstream models, run mega-analysis across multiple datasets, or evaluate models with leave-site-out / site-stratified protocols. Triggers include: 'harmonize', 'ComBat', 'CovBat', 'site effect', 'scanner effect', 'batch effect', 'leave-site-out', 'mega-analysis', 'multi-site', 'cross-site', 'neuroHarmonize'. This is a horizontal cross-cutting layer between dataset skills and mo.

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# Harmonization Tool Skill (Cross-Site Feature Alignment Layer)

## Overview
`harmonization-tool` is the NeuroClaw cross-cutting layer that sits **between** dataset skills (ABIDE, ADHD-200, ABCD, HCP, UKB, ...) and model skills (BrainGNN, BNT, IBGNN, LGGNN, BrainNetCNN, FM-APP, SVM, SpaceNet, ...).

Its job: take subject-level features extracted by dataset skills and remove **technical / batch variance** introduced by site, scanner, field strength, sequence, or dataset, while **preserving biological variance** (age, sex, diagnosis, ...).

This is the prerequisite for any honest **mega-analysis** that pools individual-participant data (IPD) across sites or datasets.

This skill follows NeuroClaw hierarchy:
- Defines **WHAT to do**, not low-level implementation details.
- Does **not** execute direct shell commands itself.
- Delegates all execution via `claw-shell`.

**Research use only.**

---

## When to Use This Skill

Trigger this skill when the user asks for any of:
- "harmonize features across sites / scanners / datasets"
- "ComBat / ComBat-GAM / CovBat / neuroHarmonize / neuroCombat"
- "remove site effect / scanner effect / batch effect"
…

Read the whole file at its exact version.

How to install

Latest version
mdr add cuhk-aim-group/neurodiscovery/harmonization-tool@git:20260523.efa9db2
Exact content
mdr add cuhk-aim-group/neurodiscovery/harmonization-tool@sha256:0b5800d4e097de9d

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_vqctohcv2iom7jzq.svg)](https://markdownregistry.com/a/art_vqctohcv2iom7jzq)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260523.efa9db2 latest2026-05-23 efa9db2 14,966 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (14966 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

cuhk-aim-group/neurodiscovery · 91 stars · license MIT · pushed 2026-09-22 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_vqctohcv2iom7jzq
GET https://markdownregistry.com/api/v1/resolve?ref=cuhk-aim-group/neurodiscovery/harmonization-tool
GET https://markdownregistry.com/api/v1/blob/0b5800d4e097de9d9cae232fced0a315fa76f5e478e23c25f911336456098855

Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

More from cuhk-aim-group/neurodiscovery

abcd-skill skill
cuhk-aim-group/neurodiscovery · skills/abcd-skill/SKILL.md · Use this skill whenever the user wants an end-to-end workflow for the ABCD Study dataset, including controlled access…
git:20260825.f7533a2 · audit A · 91 stars
abide-skill skill
cuhk-aim-group/neurodiscovery · skills/abide-skill/SKILL.md · Use this skill whenever the user wants an end-to-end workflow for the ABIDE (Autism Brain Imaging Data Exchange)…
git:20260505.e9ddd22 · audit A · 91 stars
academic-research-hub skill
cuhk-aim-group/neurodiscovery · skills/academic-research-hub/SKILL.md · Use this skill when users need to search academic papers, download research documents, extract citations, or gather…
git:20260506.86420c0 · audit A · 91 stars
adhd200-skill skill
cuhk-aim-group/neurodiscovery · skills/adhd200-skill/SKILL.md · Use this skill whenever the user wants an end-to-end workflow for the ADHD-200 dataset, including download, BIDS…
git:20260505.e9ddd22 · audit A · 91 stars
adni-skill skill
cuhk-aim-group/neurodiscovery · skills/adni-skill/SKILL.md · Use this skill whenever the user wants an end-to-end workflow for ADNI or ADNI-DOD data, including controlled LONI IDA…
git:20260825.f7533a2 · audit A · 91 stars
aibl-skill skill
cuhk-aim-group/neurodiscovery · skills/aibl-skill/SKILL.md · Use this skill whenever the user wants an end-to-end workflow for the AIBL (Australian Imaging, Biomarkers and…
git:20260506.f8d0216 · audit A · 91 stars
aomic-skill skill
cuhk-aim-group/neurodiscovery · skills/aomic-skill/SKILL.md · Use this skill whenever the user wants an end-to-end workflow for the AOMIC (Amsterdam Open MRI Collection) dataset…
git:20260506.f8d0216 · audit A · 91 stars
asl-skill skill
cuhk-aim-group/neurodiscovery · skills/asl-skill/SKILL.md · Use this skill whenever the user wants to process Arterial Spin Labeling (ASL) perfusion MRI data including CBF…
git:20260506.f8d0216 · audit A · 91 stars
beautiful-log skill
cuhk-aim-group/neurodiscovery · skills/beautiful-log/SKILL.md · Use this skill after a conversation or task is completed when the user wants a clean, beautiful HTML chat log. It keeps…
git:20260506.86420c0 · audit A · 91 stars
bids-organizer skill
cuhk-aim-group/neurodiscovery · skills/bids-organizer/SKILL.md · Use this skill whenever the user wants to automatically organize raw neuroimaging data (DICOM, NIfTI, EEG, etc.) into a…
git:20260506.86420c0 · audit A · 91 stars
bnt skill
cuhk-aim-group/neurodiscovery · skills/bnt/SKILL.md · Use this model doc whenever the user wants to run BrainNetworkTransformer for fMRI phenotype prediction, including data…
git:20260515.bfd8dae · audit A · 91 stars
bold5000-skill skill
cuhk-aim-group/neurodiscovery · skills/bold5000-skill/SKILL.md · Use this skill whenever the user wants an end-to-end workflow for the BOLD5000 dataset, including download, BIDS…
git:20260505.e9ddd22 · audit A · 91 stars

Every file in cuhk-aim-group/neurodiscovery

Browse by kind, by grade A, or by owner.