rest-mneta-mdd-skill

Orchestrates BIDS validation, rs-fMRI processing, phenotype extraction, and QC for the REST-meta-MDD dataset.

89|5|Updated Mar 25, 2026
One-click install
npx skills add https://github.com/CUHK-AIM-Group/NeuroDiscovery --skill rest-mneta-mdd-skill-cuhk-aim-group
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rest-mneta-mdd-skill
Source: https://github.com/CUHK-AIM-Group/NeuroDiscovery/tree/main/skills/rest-mneta-mdd-skill
Command: npx skills add https://github.com/CUHK-AIM-Group/NeuroDiscovery --skill rest-mneta-mdd-skill-cuhk-aim-group

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires numpy, pandas, neuroCombat, and includes scripts (resource) components.

What problem does it solve? Processing the REST-meta-MDD multi-site depression neuroimaging dataset requires coordinating BIDS validation, resting-state fMRI preprocessing, clinical phenotype extraction, site harmonization, and quality control across roughly 3,600 subjects from 17 sites, which is error-prone when done manually. ## Core Features & Use Cases - BIDS Validation: Scans REST-meta-MDD subject directories, checks for required rs-fMRI files, detects site IDs, and produces a compliance report CSV. - Phenotype Extraction: Merges diagnosis, HAMD, HAMA, medication, and demographic columns from heterogeneous phenotype files into one subject-aligned table. - Multi-Site Harmonization: Applies ComBat or site-wise z-score normalization to correct scanner and site effects across the 17 collection sites. - QC Summaries: Computes framewise displacement metrics from fMRIPrep confounds and generates per-subject exclusion lists with site-level summaries. - Use Case: A researcher downloads REST-meta-MDD data and asks for an end-to-end pipeline; the skill validates the BIDS structure, delegates rs-fMRI preprocessing to fmri-skill, extracts clinical phenotypes, harmonizes site effects, and outputs a clean rest_mdd_output/ directory. ## Quick Start Ask the agent to run the full REST-meta-MDD pipeline on your local BIDS dataset, starting with validation and proceeding through rs-fMRI processing, phenotype extraction, and QC after you confirm the plan.

Frequently Asked Questions about rest-mneta-mdd-skill

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

FAQPage Schema
How do I process the REST-meta-MDD dataset end to end?

Request the REST-meta-MDD workflow and the skill generates a numbered plan covering BIDS validation, rs-fMRI preprocessing via fmri-skill, phenotype extraction, site harmonization, and QC. Execution only begins after you explicitly confirm the plan.

How to validate BIDS structure for REST-meta-MDD data?

Run scripts/validate_rest_mdd.py with --input pointing to your BIDS directory and --output for the report path. It checks each subject for task-rest BOLD files, optional T1w anatomy, extracts site IDs, and writes a compliance CSV.

How do I correct site effects in multi-site fMRI data?

Use scripts/harmonize_sites.py with --method combat for ComBat harmonization or --method zscore for site-wise z-score normalization. ComBat requires the neuroCombat package; otherwise the script falls back to z-scoring with a warning.

What clinical measures are available in REST-meta-MDD?

The dataset includes SCID-based diagnosis, HAMD depression severity, HAMA anxiety severity, medication status, site, age, sex, and education. The phenotype extraction script maps heterogeneous column names into a merged per-subject CSV.

Does this skill run preprocessing pipelines directly?

No, it is an orchestration-only layer that delegates actual preprocessing to fmri-skill and smri-skill through claw-shell. Its own scripts handle only validation, phenotype merging, harmonization, and QC summaries.

What are the limitations of REST-meta-MDD analysis?

Scanner heterogeneity across 17 sites introduces variability requiring harmonization, structural T1w data is only available at some sites, and medication status is a confound. Subgroup analyses of medicated versus drug-naive patients are recommended.