eeg-bids

Convert raw EEG recordings into BIDS-EEG layouts with MNE-BIDS validation.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill converts lab-specific raw EEG files into a BIDS-EEG directory structure so downstream analyses can consume consistent, machine-readable inputs.

Core Features & Use Cases

  • BIDS-EEG conversion from multiple raw formats: supports BrainVision, EEGLAB, EDF/BDF, MNE-FIF, Neuroscan, and EGI/MFF via an MNE-Python/MNE-BIDS backend.
  • Metadata and event mapping: reads paradigm and marker code mappings from DATASET_BRIEF.md and writes BIDS-compliant events.tsv and sidecar JSONs.
  • Validation and reporting: generates structured validation reports and a backend resolution file for reproducibility.
  • Use case: you have a project with raw EEG in a non-BIDS layout and want to standardize it before running preprocessing, ICA, and ERP/TFR/stats skills.

Quick Start

Run eeg-bids on your project directory so it scans raw/ and writes BIDS-formatted outputs into bids-stage/.

Frequently Asked Questions about eeg-bids

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

FAQPage Schema
How do I convert raw EEG recordings into a BIDS-EEG directory structure?

You convert raw EEG recordings into a BIDS-EEG directory structure by running a Skill that scans raw project files and uses MNE-BIDS to write standardized BIDS-formatted outputs into a bids-stage directory.

What raw EEG file formats can I convert to BIDS using MNE-BIDS?

MNE-BIDS supports converting BrainVision, EEGLAB, EDF/BDF, MNE-FIF, Neuroscan, and EGI/MFF raw EEG formats into a standardized BIDS-EEG layout for downstream analysis.

How do I map event marker codes when converting EEG data to BIDS?

To map event marker codes during EEG BIDS conversion, you define your paradigm and marker code mappings in a DATASET_BRIEF.md file, which the Skill reads to generate BIDS-compliant events.tsv and sidecar JSONs.

Does converting EEG to BIDS require a validation check?

Yes, converting EEG to BIDS requires validation checks; the process uses MNE-BIDS and validator checks to ensure the generated participants, events, and sidecar files meet BIDS compliance and produces a structured validation report.

When do I need to standardize my EEG data into the BIDS format?

You need to standardize your EEG data into the BIDS format when you have a project with raw EEG in a non-BIDS layout and want consistent, machine-readable inputs before running preprocessing, ICA, and ERP/TFR/stats skills.

Can I use eeg-bids to prepare heterogeneous lab EEG files for reproducible analysis?

Yes, eeg-bids converts heterogeneous lab-specific raw EEG files into a BIDS-EEG directory structure, generating a backend resolution file for reproducibility and providing consistent machine-readable inputs for downstream analysis.