abcd-skill

Orchestrates ABCD Study data download, BIDS staging, and multimodal MRI processing workflows.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Working with the ABCD Study dataset requires navigating controlled NBDC access, converting NDAR-style raw data into BIDS-compliant layouts, and coordinating separate sMRI, fMRI, and dMRI pipelines. This Skill provides a single orchestration entry point that manages the full workflow from approved download through staging, modality delegation, phenotype merging, and QC reporting. ## Core Features & Use Cases - BIDS Reorganization: Converts raw ABCD NIfTI files with NDAR subject IDs and event names into BIDS-compliant structures with dataset_description.json and participants.tsv via scripts/reorganize_abcd.py. - Phenotype Extraction: Merges tab-delimited ABCD phenotype tables (mental health, CBCL, KSADS) with visit alignment and imaging subject cross-referencing via scripts/extract_abcd_phenotype.py. - QC Summaries: Combines fMRIPrep confounds, FreeSurfer metrics, and ABCD native QC flags into per-subject exclusion lists via scripts/abcd_qc_summary.py. - Use Case: A researcher with approved NBDC access downloads ABCD 7.0 imaging data, stages it into BIDS format, delegates T1w processing to smri-skill and resting-state fMRI to fmri-skill, then merges CBCL phenotype scores and generates a motion-based exclusion list for statistical analysis. ## Quick Start Ask the agent to organize the local raw ABCD NIfTI directory into a BIDS-compliant dataset and generate the participants and dataset description files.

Frequently Asked Questions about abcd-skill

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

FAQPage Schema
How do I convert ABCD Study raw data to BIDS format?

Run the reorganize_abcd.py script with --input pointing to the raw ABCD directory and --output for the BIDS target. It normalizes NDAR subject IDs to sub- labels, maps event names to sessions, routes T1w, T2w, dMRI, and fMRI files to anat, dwi, and func folders, and writes dataset_description.json and participants.tsv.

How do I access and download ABCD Study data?

ABCD data is distributed through the NIH Brain Development Cohorts (NBDC) Data Sharing Platform. Access requires an approved Data Use Certification, NIH-recognized institutional affiliation, signing-official approval, and an active Federalwide Assurance. Release 6.0 and later are no longer hosted on NDA.

How do I merge ABCD phenotype tables with imaging subject lists?

Use extract_abcd_phenotype.py with --phenotype-dir for the tab-delimited files and --imaging-ids pointing to a BIDS participants.tsv. It merges tables on subject_id and eventname, filters to subjects with imaging data, and drops columns exceeding a missing-value threshold.

What QC metrics are used to exclude ABCD subjects?

The abcd_qc_summary.py script combines mean and max framewise displacement from fMRIPrep confounds, FreeSurfer recon-all completion status, and ABCD native imgincl01 include flags. Default exclusion thresholds are mean FD above 0.3 mm and max FD above 5.0 mm.

Can I use this skill for BIDS staging only without full processing?

Yes, a narrow path handles local raw ABCD NIfTI staging without downloading or delegating to modality pipelines. It performs subject and session normalization, modality routing, sidecar copying, and minimal metadata generation, with a --dry-run mode for previewing changes.

What are the storage requirements for ABCD imaging data?

Full-cohort ABCD imaging data can exceed 10 TB, so the destination directory must have sufficient disk space before download. Processing is also CPU and RAM intensive, and partial download failures are handled with retry lists rather than aborting the batch.