SkillAtlasSkill 详情

cpm

     

审核状态:已审核Quality 72Security 70

复制安装命令

用 Codex 或 Claude 安装复制这段 Prompt,粘贴到 Codex、Claude 或其他助手里,让它先审查 Skill 页面再帮你安装。

复制前请先查看来源、License 和安全提示。

项目 README

来源文件:README.md

抓取于 2026年9月14日
NeuroDiscovery Logo

NeuroDiscovery: a closed-loop framework for evidence-grounded neuroimaging autoresearch

CUHK logo       Massachusetts General Hospital logo       Lehigh University logo

Python Platform License Skills arXiv Homepage NeuroOracle

中文版 README

📖 Overview

NeuroDiscovery is a closed-loop framework for evidence-grounded neuroimaging autoresearch. It comprises a neuroscience knowledge graph, a hypothesis generator and NeuroRuntime, an agent-based execution platform.

The graph combines curated resources with source-linked literature evidence, preserving provenance, publication dates and evidence polarity. The generator constructs testable cross-domain hypotheses compatible with available data and analysis methods. NeuroRuntime tests selected hypotheses reproducibly on raw neuroimaging data; supported, contradicted and inconclusive outcomes guide subsequent research, separately from execution failures.

NeuroRuntime retains the project's strengths in neuroimaging dataset and model adaptation, data processing and model configuration/execution. It ships with independent GUI and CLI interfaces for day-to-day use, and can also be installed as a reusable skill library inside agent projects such as OpenClaw, Hermes, and Claude Code.

NeuroDiscovery and research materials

This repository hosts NeuroDiscovery (formerly NeuroClaw) and related public resources. Existing directory and interface names, including neurooracle/, neurobench/, neuroclaw_environment.json, the neuroclaw host-agent skill and neuroclaw_academic_* MCP tools, are retained for compatibility.

Public materials have separate versions:

ResourceAvailability
Neuroimaging execution tasks500 task definitions, T01–T500, with a complete seven-category task registry. See the benchmark README.
Knowledge-graph explorerThe NeuroOracle demo provides interactive graph exploration. Its loaded snapshot can differ from the research graph. See the graph version notes.
Benchmark outputsSelected historical evaluation outputs are available. Their task coverage is recorded per run.
NeuroDiscovery manuscript releaseThe frozen graph, paper-specific evaluation outputs and figure source data are being prepared for a versioned research release. A release identifier and artifact manifest will be linked here when available.

The linked NeuroClaw technical report describes an earlier project version. Its experiments and the public demo should be interpreted using their own version information, separately from the NeuroDiscovery manuscript.


🚀 Updates

  • [2026.06.20]: NeuroClaw now provides Windows and macOS desktop clients, while Linux remains supported through the repository and command-line/web workflows.
  • [2026.05.23]: NeuroBench now covers both data processing and model training/evaluation.
  • [2026.05.20]: 7 atoms × 15 canonical tasks + 4 mediation chains in neurooracle.atoms.
  • [2026.05.15]: NeuroOracle launched: knowledge-graph explorer plus hypothesis engine with live demo at https://huggingface.co/spaces/zxcvb20001/NeuroOracle.
  • [2026.05.06]: Added 19 dataset and modality skills with companion scripts; all 86 skills enforce unified metadata (layer, skill_type, dependencies); skill_loader DAG validation ensures dependency graph correctness.
  • [2026.04.28]: Our technical report is now available on arXiv: https://arxiv.org/abs/2604.24696
  • [2026.04.22]: v1.0 released. Stable release with improvements and full documentation.
  • [2026.04.17]: Our project homepage is now live. Welcome to visit: https://cuhk-aim-group.github.io/NeuroDiscovery/
  • [2026.04.08]: NeuroBench released for multi-agent neuroimaging workflow evaluation.
  • [2026.04.02]: v0.1 released with complete NeuroClaw framework and core functionality.

✨ Key Features

NeuroDiscovery Workflow Overview

🔄 Data-Aware Orchestration

  • Dataset-Context Planning: Organize capabilities around dataset structure, metadata, and workflow stage instead of simply "which tool to call"
  • Automatic Skill Recommendation: Users specify the target dataset, and NeuroRuntime recommends relevant skills and executable workflows
  • Preprocessing Constraint Awareness: Dataset-specific modality availability and preprocessing requirements are considered during orchestration

Supported Dataset Overview

Show supported dataset table
DatasetSupported ModalitiesAdditional DataCohort ScaleOfficial Link
ABCD StudyT1w; T2w; dMRI; rs-fMRI; task-fMRIPhysical and mental health; substance use; culture/environment; neurocognition; biological dataTarget cohort of ~11,500 children; current releases through the NBDC Data Sharing Platformhttps://abcdstudy.org/
ABIDET1w; rs-fMRIASD/control phenotypic data1,112 datasets from 17 international siteshttps://fcon_1000.projects.nitrc.org/indi/abide/
ADHD-200T1w; rs-fMRIDiagnostic status; ADHD symptom measures; demographics; medication history; QC measures776 participants/datasets across 8 imaging siteshttps://fcon_1000.projects.nitrc.org/indi/adhd200/
AIBLT1w; PET (PiB, FDG, tau)Cognitive assessments; blood biomarkers; lifestyle and demographic data; APOE genotype~1,100+ participants (healthy controls, MCI, AD)https://aibl.csiro.au/
AOMICT1w; rs-fMRI; task-fMRIPersonality traits (Big Five); fluid intelligence; demographic data~1,000+ participantshttps://nilab-uva.github.io/AOMIC.github.io/
ADNIT1w; T2w; FLAIR; dMRI; rs-fMRI; PETGenetics/omics data; clinical and cognitive assessments~2,000+ participants across ADNI phaseshttps://adni.loni.usc.edu/
BOLD5000T1w; task-fMRIVisual image stimuli; category and image metadata4 participants with 5,000-image visual fMRI sessionshttps://bold5000-dataset.github.io/
Cam-CANT1w; T2*w; rs-fMRI; task-fMRI; MEGCognitive, sensory, and health measures across the adult lifespan~700 participants ages 18-88https://www.cam-can.org/
COBRET1w; rs-fMRIDemographics; handedness; diagnostic information147 participants: 72 schizophrenia patients and 75 healthy controlshttps://fcon_1000.projects.nitrc.org/indi/retro/cobre.html
DMT-HAR-MEDrs-fMRIPsychedelic intervention conditions; behavioral and physiological measures40 participants in OpenNeuro ds006644https://openneuro.org/datasets/ds006644/versions/1.0.1
HBNT1w; T2w; dMRI; rs-fMRI; task-fMRI; EEGPsychiatric, behavioral, cognitive, lifestyle, genetics, actigraphy~3,900+ released participants; target resource of at least 10,000 ages 5-21https://fcon_1000.projects.nitrc.org/indi/cmi_healthy_brain_network/
HCP AgingT1w; T2w; dMRI; rs-fMRI; task-fMRI; ASLBehavioral, cognitive, health, and demographic measuresAABC Release 2: 1,396 participants and 2,878 sessionshttps://www.humanconnectome.org/study/hcp-lifespan-aging
HCP DevelopmentT1w; T2w; dMRI; rs-fMRI; task-fMRIBehavioral, cognitive, health, and demographic measures~600+ children and adolescents ages 5-21https://www.humanconnectome.org/study/hcp-lifespan-development
HCP Early PsychosisT1w; T2w; dMRI; rs-fMRI; task-fMRIDiagnostic, clinical, behavioral, and cognitive measures~250 early psychosis and control participantshttps://www.humanconnectome.org/study/hcp-early-psychosis
HCP Young AdultT1w; T2w; dMRI; rs-fMRI; task-fMRIBehavioral and cognitive measures2025 release: unprocessed imaging for 1,113 subjects and processed data for 1,071https://www.humanconnectome.org/study/hcp-young-adult
IXIT1w; T2w; MRAHealthy brain MRI from three London hospitals~600 subjectshttps://brain-development.org/ixi-dataset/
MS ChallengeT1w; T2w; FLAIR; PDExpert manual lesion segmentations for MS benchmarking5 MS patients with multiple longitudinal timepointshttps://smart-stats-tools.org/lesion-challenge
MNDrs-fMRI; task-fMRIMotor neuron disease diagnosis and clinical measures59 participants in OpenNeuro ds005874https://openneuro.org/datasets/ds005874/versions/1.1.0
Natural Scenes DatasetT1w; task-fMRINatural image stimuli; behavioral responses; image annotations8 participants with dense repeated visual fMRIhttps://naturalscenesdataset.org/
NIFDT1w; fMRI; DTI; PETFTD clinical and cognitive data; UCSF Memory and Aging CenterFrontotemporal dementia and related disorders cohortshttps://ida.loni.usc.edu/
OASIST1w; PET (PiB)Clinical and cognitive assessments; dementia diagnosis; demographic dataCross-sectional (400+) and longitudinal (150+) participants ages 18-96https://www.oasis-brains.org/
PNCT1w; dMRI; ASL; rs-fMRI; task-fMRIGenotyping; clinical and neuropsychiatric assessment; Computerized Neurocognitive Battery>9,500 youth cohort; 1,445 participants with neuroimaginghttps://www.med.upenn.edu/bbl/philadelphianeurodevelopmentalcohort.html
PPMIT1w; rs-fMRI; DAT-SPECT; PETClinical, genetic, biospecimen, and wearable sensor data for Parkinson's disease~2,000+ participants across 30+ clinical sites worldwidehttps://www.ppmi-info.org/
REST-meta-MDDrs-fMRIMDD diagnosis; clinical and demographic measures2,428 participants across 25 cohortshttp://rfmri.org/REST-meta-MDD
SCANT1w; FLAIR; optional dMRI; rs-fMRI; ASL; amyloid/tau/FDG PETLinked NACC longitudinal clinical/cognitive data; centralized QC and imaging summariesGrowing multi-ADRC resource; requestable data depend on completed defacing and QChttps://scan.naccdata.org/
SEED-IVEEGEmotion labels across four affective categories; trial-level session metadata15 subjects across 3 sessions for emotion decoding benchmarkshttps://bcmi.sjtu.edu.cn/home/seed/
SEED-VIGEEGVigilance/fatigue labels; continuous alertness annotations; behavioral metadata23 subjects in sustained-attention driving-style vigilance recordingshttps://bcmi.sjtu.edu.cn/home/seed/
TCPrs-fMRIPsychiatric diagnostic interviews; cognitive and clinical assessments245 transdiagnostic participantshttps://openneuro.org/datasets/ds004215
UCLA CNPT1w; dMRI; rs-fMRI; task-fMRIDiagnostic groups; neuropsychological and phenotypic assessments272 participants in OpenNeuro ds000030https://openneuro.org/datasets/ds000030
UK BiobankT1w; T2w; FLAIR; dMRI; rs-fMRI; task-fMRIGenotype/genomic data; questionnaires; hospital records; environmental data; sociodemographic data; physical measures~50,000 participants with multimodal imaging datahttps://www.ukbiobank.ac.uk/

Access is not equivalent to anonymous download. See the verified access matrix for registration, DUA, review, fee, and current availability details.

🎯 Executability and Reproducibility

  • Automatic Dependency Management: No manual installation needed; the system detects and resolves dependencies
  • True Model Execution: Beyond sharing docs, it guides and executes model reproduction
  • Environment Isolation: Virtual environments and containerization avoid system pollution
  • Verifiable Processes: Complete logging and result tracking
  • Shadow Checkpoints: Git-based filesystem snapshots for rollback and diff comparison without polluting the project repository
  • Subagent Orchestration: Spawns specialized subagents (biostatistician, clinical neuroscientist, methodology expert) for multi-perspective task execution
  • Reflective Learning: Automatic reflection on tool failures and task completion, with persistent memory for cross-session learning

🧠 End-to-End Research Coverage

  • Literature Review: arXiv search, PubMed retrieval, academic resource integration
  • Experiment Design: Evidence-grounded hypothesis generation, scientific literature analysis and methodology evaluation
  • Data Processing: Multi-format conversion (DICOM ↔ NIfTI), automated preprocessing pipelines
  • Model Execution: Run published research models, deep learning framework integration
  • Result Visualization: Scientific data visualization, statistical chart generation
  • Paper Writing: Auto-generated drafts, format standardization

🤝 Flexible Integration

  • NeuroDiscovery provides standalone GUI and CLI workflows through NeuroRuntime, so researchers can use it directly without depending on another host project.
  • skills/, materials/, USER.md, and SOUL.md can also be installed as a reusable skill library in existing agent systems such as OpenClaw, Hermes, and Claude Code.
  • The bundled core/ engine provides an integrated agent loop, skill loader, and tool runtime for standalone deployments.
  • Non-neuroscience connectors (WhatsApp, Telegram, Slack, calendar, e-commerce, SaaS auth) are disabled by default via core/config/features.json and can be re-enabled if needed.

🚀 Quick Start

Option 1. Desktop Client (recommended)

Download the latest Windows or macOS client from the GitHub Releases page. Existing release assets retain their original NeuroClaw filenames.

  • Windows: use NeuroClaw Setup 0.2.1.exe for normal installation. The portable .exe is also available, but may take longer to start because it extracts the app first.
  • macOS: use the .dmg or .zip build from the release assets.
  • Open Settings to configure the model endpoint, runtime mode, Python path, FSL path, proxy, language, and text size.
  • Open NeuroOracle from the sidebar. If the graph file is missing, the client can download it from Hugging Face.

Linux remains supported through the source repository, command-line workflow, and web interface.

Option 2. Run from Source

Requirements: Python >= 3.10 and Git. Conda/Mamba, CUDA/GPU tools, FSL, FreeSurfer, and dcm2niix are optional depending on the workflows you want to run.

git clone https://github.com/CUHK-AIM-Group/NeuroDiscovery.git
cd NeuroDiscovery
python installer/setup.py
python core/agent/main.py --web

Then open http://localhost:7080 in your browser.

Useful checks:

python installer/setup.py --check
python core/agent/main.py --web --port 8080 --host 0.0.0.0

Settings are saved to neuroclaw_environment.json. API keys can be passed at runtime with --api-key or provided through the configured provider environment variable.

Option 3. Install as a Host-Agent Skill

Use this path if you want Codex, Claude Code, Cursor, or another coding agent to use NeuroDiscovery's neuroimaging skill library.

git clone https://github.com/CUHK-AIM-Group/NeuroDiscovery.git
cd NeuroDiscovery
python installer/install_agent_integration.py --target codex

Common targets:

Host agentInstall command
Codexpython installer/install_agent_integration.py --target codex
Claude Codepython installer/install_agent_integration.py --target claude-code
Cursorpython installer/install_agent_integration.py --target cursor --scope project
Multiple agentspython installer/install_agent_integration.py --target all

The installed host-agent skill retains its compatibility name, neuroclaw. After installation, ask the host agent to use NeuroClaw or enter NeuroClaw mode for neuroimaging, NeuroOracle, NeuroBench, and autoresearch tasks.

NeuroDiscovery Feature Overview

Benchmark output files under materials/benchmark_results/ are historical run artifacts. See their coverage and scoring notes before comparing them with a newer task registry.

Benchmark Evaluation

The 500 neuroimaging execution tasks live under neurobench/. Each task directory contains a task.md instruction file, and task_atlas.json assigns every task to one of seven categories. NeuroBench remains the name used by the existing benchmark interface.

NeuroBench currently accepts these benchmark configurations:

  • with-skills: the agent can use the skills loaded from skills/
  • no-skills: the baseline run without skills
  • with-skills + no-skills paired comparison: enable --benchmark-compare-skills to run both variants for the same task set

Benchmark scoring is handled separately with --score-benchmark: it reads reports in output/, applies a GPT-5.4 weighted rubric, and generates numeric scores for planning completeness, tool/skill reasonableness, and command/code correctness. For fairness, each task case is scored in one batch across all comparable models to reduce scoring-standard drift. Skill-call counts are recorded separately and used for efficiency analysis.

To score existing benchmark reports:

python core/agent/main.py --score-benchmark

To speed up scoring on larger runs:

python core/agent/main.py --score-benchmark --score-workers 8

Web benchmark mode

python core/agent/main.py --web --benchmark

CLI benchmark batch runner

python core/agent/main.py --benchmark

To run the paired skill comparison in CLI mode:

python core/agent/main.py --benchmark --benchmark-compare-skills

In CLI benchmark mode, NeuroRuntime will ask for:

  • the benchmark directory path
  • the benchmark model name

Then it will:

  • read all task.md files recursively from that directory
  • sort tasks alphabetically by task folder name
  • run tasks one by one without asking for intermediate confirmation
  • print progress in the terminal only
  • save reports under output/<model_name>/, with one markdown report per case and run

The benchmark reports include the solution thinking, skills used, skill-call counts, and the commands or code that were used or suggested.


📁 Project Structure

NeuroDiscovery/
├── README.md / README_zh.md        # Project documentation
├── USER.md / SOUL.md               # User preferences and agent behavior guidelines
│
├── core/                           # NeuroRuntime execution platform
│   ├── agent/                      # CLI/Web agent entry points
│   ├── web/                        # FastAPI Web UI
│   ├── skill_loader/               # Reads skills/*/SKILL.md
│   └── config/                     # Feature toggles and runtime settings
│
├── installer/                      # Setup wizard and host-agent integration installer
│   ├── setup.py
│   ├── config_wizard.py
│   └── install_agent_integration.py
│
├── skills/                         # Skill library
│   ├── base skills                 # Environment, search, BIDS, Git, conversion
│   ├── interface skills            # Research idea, method design, experiments, writing
│   └── subagent skills             # Tool, model, dataset, and modality workflows
│
├── models/                         # Brain model adapters and training/evaluation scripts
├── neurooracle/                    # Knowledge graph and autoresearch pipeline
│
├── neurobench/                     # 500 neuroimaging execution tasks (T01-T500)
│
├── docs/                           # Project website pages
├── materials/                      # Research materials and benchmark outputs
│
└── LICENSE                         # License

🛠️ Skill Quick Reference

Tip: Click the ℹ️ icon on any skill card in the Web UI to view expanded documentation, usage examples, and recent execution logs.

Base Layer

SkillFunctionStatus
dcm2niiDICOM → NIfTI conversion with metadata support✅
nii2dcmNIfTI → DICOM conversion for clinical interoperability✅
git-essentialsCore Git commands for collaboration✅
git-workflowsAdvanced Git workflows (rebase/worktree/bisect)✅
multi-search-engineMulti-engine web search without API keys✅
conda-env-managerConda environment lifecycle management✅
docker-env-managerDocker environment management✅
dependency-plannerDependency planning and safe installation workflow✅
claw-shellSafe shell execution gateway via dedicated session✅
overleaf-skillOverleaf sync and collaborative manuscript operations✅
academic-research-hubMulti-source academic search and paper retrieval✅
bids-organizerBase skill for organizing raw data into BIDS structure✅
beautiful-logExport clean User/NeuroDiscovery dialogue into beautiful HTML logs✅
knowledge-graph-builderBuild domain knowledge graphs from literature and databases✅
skill-updaterSkill updater and management utilities✅

Interface Layer (Task Orchestration)

SkillFunctionStatus
research-ideaBrainstorms and generates research ideas from literature✅
method-designFormalizes network architecture and derives theoretical components✅
experiment-controllerFinds and executes reproducible research experiments✅
paper-writingGenerates hierarchical manuscript drafts from IDEA/METHOD/EXPERIMENT✅

Subagent Layer

Subagent skills in NeuroRuntime include four categories: tool, model, dataset, and modality.

Tool

SkillFunctionStatus
brain-visualizationPublication-ready figures and 3D assets (connectomes, atlas summaries, FreeSurfer PLY)✅
harmonization-toolCross-site / cross-scanner feature harmonization (ComBat, ComBat-GAM, CovBat, site-as-covariate) with site-stratified and leave-site-out splitters; required for honest mega-analysis across multi-site cohorts✅
harness-coreCore harness SDK: verification, checkpointing, drift detection, audit logging✅
mne-eeg-toolBase-layer MNE-Python implementation for EEG✅
fsl-toolFSL-based sMRI/fMRI/DWI processing utilities✅
fmriprep-toolfMRIPrep pipeline wrapper and execution✅
qsiprep-toolqsiPrep pipeline wrapper for diffusion MRI✅
hcppipeline-toolHCP-style processing pipeline utilities✅
dipy-toolDiffusion MRI processing via DIPY✅
nibabel-skillLow-level neuroimaging I/O and geometry handling (NIfTI, affine, FreeSurfer I/O)✅
nilearn-toolFast neuroimaging feature extraction and decoding prep✅
conn-toolFunctional connectivity computation and analysis✅
freesurfer-toolFreeSurfer-based MRI processing and segmentation✅

Model

SkillFunctionStatus
run_modelsModel registry and model execution orchestration✅
wmh-segmentationWhite matter hyperintensity segmentation (MARS-WMH nnU-Net)✅
brain_gnnBrainGNN: graph neural network for fMRI classification✅
bntBrainNetworkTransformer: dense FC Transformer with DEC pooling for phenotype prediction✅
brainnetcnnBrainNetCNN: E2E/E2N/N2G convolutions over dense connectivity matrices✅
combraintfCom-BrainTF: community-aware two-level Transformer over dense FC matrices✅
ibgnnIBGNN: interpretable PyG-based GNN with MLP message function and edge-mask explainer✅
lggnnLG-GNN: PyG-based GNN with Self-Attention Brain Pooling and mutual-information regularization✅
fm_appFM-APP: multi-stage phenotype prediction with fMRI+sMRI✅
neurostormNeuroStorm: neuroimaging foundation model✅
glmClassical first-level and second-level GLM for task-fMRI activation and group inference✅
icaResting-state network decomposition via independent component analysis✅
dictlearningSparse resting-state network decomposition via dictionary learning✅
spacenetVoxel-wise neuroimaging disease classification with sparse coefficient maps✅
kmeansBrain parcellation via K-means clustering✅
hierarchicalMulti-scale brain parcellation via hierarchical clustering✅
filteringTemporal filtering for neuroimaging signal denoising✅
detrendingTemporal drift removal for neuroimaging signal denoising✅
statistical-mlUnified tabular OLS/GLM, SVM/SVR, Ridge, Elastic Net, XGBoost, and mixed-effects models✅
subject-subtypingSubject-level subtyping with clustering and latent embeddings✅
survival-modelsCensor-aware Cox, RSF, DeepSurv, and XGBoost survival models✅
causal-treatment-modelsCross-fitted treatment-effect and individualized policy models✅
temporal-modelsLSTM, GRU, TCN, and temporal Transformer sequence models✅
imaging-genetics-modelsAssociation, LMM, PRS, PLS, and CCA imaging-genetics models✅
cnn3dCompact residual 3D CNN for voxel-level prediction✅
cpmConnectome Predictive Modeling with fold-local edge selection✅
kg-link-predictionComplEx, R-GCN, GraphSAGE, and GAT knowledge-graph link prediction✅

Workflow

SkillFunctionStatus
neuroimaging-decodingCoordinates ROI MVPA, ROI GLM, and voxel-wise SearchLight analysis✅
connectome-discoveryConverts connectome-model outputs into significant maps and ranked targets✅
brain-age-modelingCross-validated brain-age prediction with fold-local bias correction✅

Dataset

SkillFunctionStatus
abide-skillABIDE dataset download, BIDS staging, and sMRI/rs-fMRI processing✅
aibl-skillAIBL dataset access, BIDS staging, and sMRI/PET processing✅
abcd-skillABCD Study controlled NBDC access, BIDS staging, and multimodal processing✅
adhd200-skillADHD-200 dataset download, BIDS staging, and sMRI/rs-fMRI processing✅
adni-skillADNI and ADNI-DOD controlled access, BIDS staging, and processing workflow✅
aomic-skillAOMIC dataset validation, BIDS staging, and sMRI/rs-fMRI/task-fMRI processing✅
bold5000-skillBOLD5000 dataset BIDS validation and visual task-fMRI processing✅
camcan-skillCam-CAN dataset BIDS validation, multimodal sMRI/rs-fMRI/task-fMRI/dMRI processing✅
cobre-skillCOBRE dataset BIDS staging and schizophrenia-control fMRI processing✅
dmt-har-med-skillDMT-HAR-MED dataset BIDS validation and psychedelic rs-fMRI processing✅
hbn-skillHBN dataset download, BIDS staging, and multimodal sMRI/fMRI/dMRI/EEG processing✅
hcpa-skillHCP Aging/AABC access, BIDS staging, and multimodal sMRI/fMRI/dMRI/ASL processing✅
hcpd-skillHCP Development dataset download, BIDS staging, and multimodal sMRI/fMRI/dMRI processing✅
hcpep-skillHCP Early Psychosis dataset download, BIDS staging, and multimodal sMRI/fMRI/dMRI processing✅
hcpya-skillHCP Young Adult 2025/S1200 access, BIDS staging, and multimodal sMRI/fMRI/dMRI processing✅
ixi-skillIXI dataset BIDS validation and multimodal sMRI/MRA/dMRI processing✅
mnd-skillMND dataset BIDS validation, rs-fMRI/task-fMRI processing, and phenotype extraction✅
mschallenge-skillMS Lesion Challenge BIDS validation, lesion analysis, and longitudinal tracking✅
nsd-skillNatural Scenes Dataset BIDS validation, task-fMRI processing, and COCO stimulus extraction✅
nifd-skillNIFD dataset BIDS validation, multimodal sMRI/rs-fMRI/dMRI processing for frontotemporal dementia✅
oasis-skillOASIS dataset BIDS validation, sMRI processing, and phenotype extraction for aging/AD research✅
pnc-skillPNC dataset BIDS validation, multimodal sMRI/rs-fMRI/task-fMRI/dMRI processing for developmental studies✅
ppmi-skillPPMI dataset BIDS validation, multimodal sMRI/rs-fMRI/dMRI processing for Parkinson's disease✅
rest-mneta-mdd-skillREST-meta-MDD multi-site rs-fMRI processing, site harmonization, and depression phenotype extraction✅
scan-skillSCAN/NACC access planning, approved-export staging, phenotype linkage, and multimodal MRI/PET processing✅
seed-iv-skillSEED-IV EEG emotion recognition (4 emotions), feature extraction, and classification✅
seed-vig-skillSEED-VIG EEG vigilance/fatigue detection, feature extraction, and drowsiness classification✅
tcp-skillTransdiagnostic Connectome Project BIDS validation, multimodal sMRI/rs-fMRI/dMRI processing✅
ucla-cnp-skillUCLA CNP BIDS validation, multimodal sMRI/task-fMRI/dMRI processing, multi-disorder phenotyping✅
ukb-skillUKB brain imaging automated processing workflow✅

Modality

SkillFunctionStatus
eeg-skillEEG preprocessing and feature extraction workflows✅
fmri-skillFunctional MRI preprocessing and analysis workflows✅
smri-skillStructural MRI preprocessing and analysis workflows✅
dwi-skillDiffusion MRI preprocessing and analysis workflows✅
pet-skillPET imaging workflows (SUVR computation, reference regions, PVC)✅
asl-skillASL perfusion MRI workflows (CBF quantification, Buxton model)✅
meg-skillMEG processing workflows (source localization, time-frequency, connectivity)✅

Legend: ✅ Implemented | 🏗️ In Development | ⏳ Planned


🙏 Acknowledgments

Thanks to:

Agent / MCP / Skill 创作

中风险

  • 来源需自行核对维护者身份。
  • 包含脚本或命令调用,安装前请复核。
  • 可能需要外部 token、网络权限或第三方服务。
  • 未检测到高风险命令。
  • 扫描发现:2 条。

Codex — Git Clone 安装

  1. 安装前请先查看来源仓库和风险报告。
  2. 克隆仓库:git clone https://github.com/CUHK-AIM-Group/NeuroDiscovery.git
  3. 将 "skills/cpm" 文件夹复制到 Codex 的 skills 目录中。
  4. 重启 Codex 让新的 skill 生效。

Codex — 手动复制安装

  1. 安装前请先查看来源仓库和风险报告。
  2. 从源仓库下载 SKILL.md 及相关文件。
  3. 在 Codex 的 skills 目录中创建新文件夹。
  4. 将所有 skill 文件复制到新文件夹中。
  5. 重启 Codex 让新的 skill 生效。

Claude Code — Git Clone 安装

  1. 安装前请先查看来源仓库和风险报告。
  2. 克隆仓库:git clone https://github.com/CUHK-AIM-Group/NeuroDiscovery.git
  3. 将 "skills/cpm" 文件夹复制到 Claude Code 的 skills 目录中。
  4. 重启 Claude Code 让新的 skill 生效。

Claude Code — 手动复制安装

  1. 安装前请先查看来源仓库和风险报告。
  2. 从源仓库下载 SKILL.md 及相关文件。
  3. 在 Claude Code 的 skills 目录中创建新文件夹。
  4. 将所有 skill 文件复制到新文件夹中。
  5. 重启 Claude Code 让新的 skill 生效。

Cursor — Git Clone 安装

  1. 安装前请先查看来源仓库和风险报告。
  2. 克隆仓库:git clone https://github.com/CUHK-AIM-Group/NeuroDiscovery.git
  3. 将 "skills/cpm" 文件夹复制到 Cursor 的 skills 目录中。
  4. 重启 Cursor 让新的 skill 生效。

Cursor — 手动复制安装

  1. 安装前请先查看来源仓库和风险报告。
  2. 从源仓库下载 SKILL.md 及相关文件。
  3. 在 Cursor 的 skills 目录中创建新文件夹。
  4. 将所有 skill 文件复制到新文件夹中。
  5. 重启 Cursor 让新的 skill 生效。

GitHub Copilot — Git Clone 安装

  1. 安装前请先查看来源仓库和风险报告。
  2. 克隆仓库:git clone https://github.com/CUHK-AIM-Group/NeuroDiscovery.git
  3. 将 "skills/cpm" 文件夹复制到 GitHub Copilot 的 skills 目录中。
  4. 重启 GitHub Copilot 让新的 skill 生效。

GitHub Copilot — 手动复制安装

  1. 安装前请先查看来源仓库和风险报告。
  2. 从源仓库下载 SKILL.md 及相关文件。
  3. 在 GitHub Copilot 的 skills 目录中创建新文件夹。
  4. 将所有 skill 文件复制到新文件夹中。
  5. 重启 GitHub Copilot 让新的 skill 生效。

Windsurf — Git Clone 安装

  1. 安装前请先查看来源仓库和风险报告。
  2. 克隆仓库:git clone https://github.com/CUHK-AIM-Group/NeuroDiscovery.git
  3. 将 "skills/cpm" 文件夹复制到 Windsurf 的 skills 目录中。
  4. 重启 Windsurf 让新的 skill 生效。

Windsurf — 手动复制安装

  1. 安装前请先查看来源仓库和风险报告。
  2. 从源仓库下载 SKILL.md 及相关文件。
  3. 在 Windsurf 的 skills 目录中创建新文件夹。
  4. 将所有 skill 文件复制到新文件夹中。
  5. 重启 Windsurf 让新的 skill 生效。
查看 SKILL.md 原文
name: cpm
description: "Use this model skill whenever the user wants Connectome Predictive Modeling with fold-local functional-connectivity edge selection for classification or regression. Triggers include 'CPM', 'connectome predictive modeling', 'functional connectivity prediction', 'positive network', 'negative network', and 'edge selection'."
license: MIT
layer: base
skill_type: model
dependencies:
  - fmri-skill
  - run_models

CPM Skill

Overview

cpm is the canonical NeuroClaw implementation of Connectome Predictive Modeling. Edge selection is repeated independently inside every training fold.

TaskInputOutput
Classificationsubject FC matrices/vectorsclass and probability
Regressionsubject FC matrices/vectorscontinuous prediction

Installation

pip install numpy pandas scipy scikit-learn joblib

Workflows

1. Prepare data

connectomes.npz:

X:          [subjects, nodes, nodes] or [subjects, edges]
subject_id: [subjects]

labels.csv contains the same subject IDs and a target column.

2. Regression

python skills/cpm/scripts/train_reference.py \
  --connectomes connectomes.npz \
  --labels labels.csv \
  --target cognitive_score \
  --subject-col subject_id \
  --task regression \
  --p-threshold 0.01 \
  --folds 5 \
  --output-dir run_models_output/cpm

3. Classification

python skills/cpm/scripts/train_reference.py \
  --connectomes connectomes.npz \
  --labels labels.csv \
  --target diagnosis \
  --task classification \
  --p-threshold 0.01 \
  --output-dir run_models_output/cpm_classification

If p-threshold is tuned, use nested validation or training-only selection.


Input / Output Summary

ItemFormat
Connectomes.npz with X, subject_id
LabelsCSV keyed by subject ID
Predictionspredictions.csv
Fold membershipfold_assignments.csv
Metricsmetrics.json
Fold modelscheckpoint.joblib
Provenanceconfig.json, run_manifest.json

Testing

pytest models/tests/test_extended_models.py -q
python skills/cpm/scripts/train_reference.py --help

Directory Reference

models/cpm/
├── cpm.py              fold-local CPM estimator
└── train.py            cross-validated CLI

skills/cpm/
├── SKILL.md
└── scripts/train_reference.py

Reference

  • Finn et al. functional connectome fingerprinting and connectome-based prediction framework, Nature Neuroscience (2015).

Created At: 2026-07-29 HKT Last Updated At: 2026-07-29 HKT Author: chengwang96

发现问题?提交给管理员复核

评分:

评论 (0)

暂无评论,成为第一个评论者吧!