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.