eeg-stats

Run claim-driven EEG group statistics with cluster-based permutation tests.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/dengzhe-hou/auto-eeg-analysis --skill eeg-stats
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: eeg-stats
Source: https://github.com/dengzhe-hou/auto-eeg-analysis/tree/main/skills/eeg-stats
Command: npx skills add https://github.com/dengzhe-hou/auto-eeg-analysis --skill eeg-stats

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires mne, scipy, numpy, python.

What problem does it solve?

This Skill turns pre-defined EEG claims into rigorous, reproducible group-level statistics so you can test hypotheses without ad-hoc choices.

Core Features & Use Cases

  • Claim-driven cluster permutation testing: Runs spatio-temporal cluster permutation tests (directional or two-sided) for ERP/TFR/connectivity contrasts specified in ANALYSIS_PLAN.
  • ROI + channel-mapping guardrails: Enforces planned time windows and ROI channels, using channel_mapping.json to resolve 10-20 names to numbered channels and stopping when mappings are missing.
  • COBIDAS-ready statistical outputs: Writes per-claim JSON verdicts plus reproducibility artifacts (arrays and backend resolution) and appends a structured FINDINGS.md entry.
  • Multiple-comparisons controls: Applies the multiple-comparisons strategy defined in ANALYSIS_PLAN (e.g., Bonferroni or hierarchical).

Quick Start

Use the eeg-stats Skill to compute cluster permutation group statistics for your frozen ANALYSIS_PLAN by running it on a prepared project directory (with stats prerequisites generated by earlier ERP/TFR stages).

Frequently Asked Questions about eeg-stats

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

FAQPage Schema
How do I run cluster-based permutation tests for EEG group statistics?▼

Cluster-based permutation tests for EEG group statistics can be run by applying a Skill to a prepared project directory containing a frozen ANALYSIS_PLAN.md and stage outputs to evaluate pre-registered directional or two-sided contrasts.

How do I enforce pre-registered ROI channels and time windows during EEG statistical analysis?▼

To enforce pre-registered ROI channels and time windows during EEG statistical analysis, the process uses a channel_mapping.json file to resolve 10-20 names to numbered channels, halting execution if any required mappings are missing.

Does MNE-Python support claim-driven multiple comparisons correction for ERP and time-frequency data?▼

MNE-Python supports claim-driven multiple comparisons correction by applying strategies like Bonferroni or hierarchical controls defined in a frozen ANALYSIS_PLAN.md to ERP, time-frequency, or connectivity stage outputs.

What is the best way to generate reproducible EEG statistical outputs for COBIDAS compliance?▼

The best way to generate reproducible EEG statistical outputs for COBIDAS compliance is running claim-driven group statistics that output per-claim JSON verdicts, arrays, and structured FINDINGS.md reproducibility artifacts.

Can I use cluster permutation testing for both paired and independent EEG study designs?▼

Cluster permutation testing can be applied to both paired and independent EEG study designs when pre-registered claims specify contrasts, regions of interest, time windows, and directional hypotheses in the analysis plan.

What prerequisites are needed before computing EEG group-level hypothesis tests?▼

Prerequisites for computing EEG group-level hypothesis tests include a frozen ANALYSIS_PLAN.md, ERP or time-frequency stage outputs, an ENVIRONMENT.json for MNE resolution, and channel_mapping.json for ROI channel alignment.