eeg-spectral

Compute EEG power spectral density and band power from preprocessed or epoched data.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Spectral-domain EEG analysis is slow and error-prone when you need defensible PSD, band-power metrics, and aperiodic+periodic decomposition (e.g., specparam/FOOOF) rather than just raw FFT plots.

Core Features & Use Cases

  • Power spectral density (PSD): computes resting-state (continuous) and task-related (epoched) PSD using Welch by default, with configurable frequency bounds and FFT resolution.
  • Band power extraction: derives canonical (delta/theta/alpha/beta/gamma) or user-specified bands with clear output for absolute vs dB-style reporting decisions.
  • Aperiodic+periodic decomposition: optionally runs specparam/FOOOF to estimate 1/f aperiodic parameters and detect periodic peaks, including goodness-of-fit reporting.
  • Individual Alpha Peak Frequency (IAPF): optionally extracts IAPF per subject (from specparam peaks or PSD peak-detection) to support individualized alpha-band definitions.
  • Publication-ready outputs: writes spectral plans and subject/group artifacts plus figure-stage PSD plots, topomaps, and IAPF/IAPF-related visuals.

Quick Start

Ask the agent to run /eeg-spectral projects/my-study to compute PSD and band power from the appropriate preprocessing/epoch stage, and enable specparam/FOOOF with optional IAPF extraction if requested.

Frequently Asked Questions about eeg-spectral

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

FAQPage Schema
How do I compute EEG power spectral density and band power for resting-state or task-related data?▼

EEG power spectral density and band power are computed using Welch's method for both continuous resting-state and epoched task-related data, with configurable frequency bounds and FFT resolution to produce validated spectral-stage outputs.

What is aperiodic and periodic decomposition in EEG spectral analysis?▼

Aperiodic and periodic decomposition separates the 1/f aperiodic background slope from oscillatory periodic peaks using the specparam (FOOOF) model, reporting goodness-of-fit to characterize distinct neural spectral components.

How do I extract Individual Alpha Peak Frequency (IAPF) from EEG power spectra?▼

Individual Alpha Peak Frequency (IAPF) is extracted per subject by detecting peaks from specparam decomposition results or direct PSD peak-detection, supporting individualized alpha-band definitions for resting-state or task analyses.

Can I generate publication-ready PSD plots and topomaps from EEG spectral analysis?▼

Publication-ready outputs include figure-stage PSD plots, topomaps, and IAPF-related visualizations generated alongside spectral plans and subject or group artifacts with validated frequency ranges and sanity checks.

Does EEG spectral analysis with FOOOF require preprocessed or epoched data inputs?▼

EEG spectral analysis with FOOOF requires reading DATASET_BRIEF.md and ANALYSIS_PLAN.md, consuming preprocess-stage or epoch-stage inputs, and writing spectral-stage outputs to ensure validated frequency ranges and sanity checks.

What is the best way to report absolute versus dB-style EEG band power metrics?▼

EEG band power metrics for canonical bands like delta, theta, alpha, beta, and gamma are extracted with clear output formatting supporting decisions between absolute power and dB-style reporting for downstream claims.