Source profileQuality 91/100

NeuroAIHub/BrainPilot/packages/skills/skills/05_EEG_ERP/erp-analysis/SKILL.md

erp-analysis

Domain-validated pipeline and parameter guidance for event-related potential analysis, from preprocessing through statistical testing

Source repository stars
463
Declared platforms
0
Static risk flags
0
Last source update
2026-08-25
Source checked
2026-08-28

Decision brief

What it does: where it fits

Domain-validated pipeline and parameter guidance for event-related potential analysis, from preprocessing through statistical testing

Best for

  • Designing an ERP preprocessing pipeline for a new study
  • Choosing filter settings, reference schemes, or artifact rejection criteria
  • Identifying which ERP component to measure and how to define its time window and ROI

Not for

  • Double-dipping: Selecting time windows or electrodes based on the effect of interest, then testing that same effect in the selected window (Kriegeskorte et al., 2009)
  • Excessive filtering: High-pass cutoffs above 0.1 Hz can distort slow components like the P300, N400, and LPC (Tanner et al., 2015; Widmann & Schroger, 2012)

Compatibility matrix

Platform support, with evidence labels

PlatformStatusEvidenceWhat to check
CodexNot declaredNo explicit evidencePortability before use
Claude CodeNot declaredNo explicit evidencePortability before use
CursorNot declaredNo explicit evidencePortability before use
Gemini CLINot declaredNo explicit evidencePortability before use
Open the compatibility checker

Installation

Inspect first. Install second.

The source command is displayed only when detected. A safe inspection prompt is always available so your agent can explain every action before execution.

Source-detected install commandSource
npx skills add https://github.com/NeuroAIHub/BrainPilot --skill "packages/skills/skills/05_EEG_ERP/erp-analysis"
Safe inspection promptEditorial

Inspect the Agent Skill "erp-analysis" from https://github.com/NeuroAIHub/BrainPilot/blob/e9ddc112cab9b1c6272dae0c8a6bdceb5c9c3880/packages/skills/skills/05_EEG_ERP/erp-analysis/SKILL.md at commit e9ddc112cab9b1c6272dae0c8a6bdceb5c9c3880. List every install step, command, network request, credential, file read/write, external action, and rollback step. Explain whether it fits my task. Do not install or execute anything until I approve.

Workflow

What the source asks the agent to do

  1. 01

    ⚠️ Verification Notice

    This skill was generated by AI from academic literature. All parameters, thresholds, and citations require independent verification before use in research. If you find errors, please open an issue.

    This skill was generated by AI from academic literature. All parameters, thresholds, and citations require independent verification before use in research. If you find errors, please open an issue.
  2. 02

    Purpose

    This skill encodes expert methodological knowledge for analyzing event-related potentials (ERPs) from EEG data. It provides domain-specific parameter recommendations, processing order guidance, component identification criteria, and statistical analysis strategies that a general…

    This skill encodes expert methodological knowledge for analyzing event-related potentials (ERPs) from EEG data. It provides domain-specific parameter recommendations, processing order guidance, component identification…
  3. 03

    When to Use This Skill

    Designing an ERP preprocessing pipeline for a new study

    Designing an ERP preprocessing pipeline for a new studyChoosing filter settings, reference schemes, or artifact rejection criteriaIdentifying which ERP component to measure and how to define its time window and ROI
  4. 04

    Research Planning Protocol

    Before executing the domain-specific steps below, you MUST:

    State the research question — What specific question is this ERP analysis addressing?Justify the method choice — Why ERP (not fMRI, behavior-only, etc.)? What alternatives were considered?Declare expected outcomes — Which component(s) do you expect to differ, in what direction?
  5. 05

    Preprocessing Pipeline Overview

    The standard ERP preprocessing pipeline involves 7 ordered steps. Processing order matters and can influence results (the "multiverse" problem; see Lonedo et al., 2020).

    Import and inspect raw data -- Check for gross artifacts, disconnected electrodesFilter -- Apply bandpass and optional notch filterRe-reference -- Choose and apply reference scheme

Permission review

Static risk signals and limitations

No configured static risk pattern was detected

This is not proof of safety. Runtime behavior, indirect dependencies, and hidden external systems are outside the static scan.

Evidence record

Why each signal appears

EvidenceSourceComputedTestedEditorial
SignalValueEvidence typeMeaning
Quality score91/100ComputedDocumentation, specificity, maintenance, and trust rules
Repository stars463SourceRepository attention, not individual Skill quality
Compatibility0 platformsSourceDeclared in the catalog source record
Usage guideautomated source guideEditorialGenerated or reviewed according to the visible evidence level

Pinned source

Provenance and original SKILL.md

Repository
NeuroAIHub/BrainPilot
Skill path
packages/skills/skills/05_EEG_ERP/erp-analysis/SKILL.md
Commit
e9ddc112cab9b1c6272dae0c8a6bdceb5c9c3880
License
AGPL-3.0
Collected
2026-08-28
Default branch
main
View the original SKILL.md

ERP Data Analysis

Purpose

This skill encodes expert methodological knowledge for analyzing event-related potentials (ERPs) from EEG data. It provides domain-specific parameter recommendations, processing order guidance, component identification criteria, and statistical analysis strategies that a general-purpose programmer or data scientist would not know without specialized training.

When to Use This Skill

  • Designing an ERP preprocessing pipeline for a new study
  • Choosing filter settings, reference schemes, or artifact rejection criteria
  • Identifying which ERP component to measure and how to define its time window and ROI
  • Selecting appropriate amplitude measures (mean, peak, area) for a given component
  • Choosing between traditional ANOVA-based analysis and mass univariate approaches
  • Reviewing or troubleshooting an existing ERP analysis pipeline

Research Planning Protocol

Before executing the domain-specific steps below, you MUST:

  1. State the research question — What specific question is this ERP analysis addressing?
  2. Justify the method choice — Why ERP (not fMRI, behavior-only, etc.)? What alternatives were considered?
  3. Declare expected outcomes — Which component(s) do you expect to differ, in what direction?
  4. Note assumptions and limitations — What does this method assume? Where could it mislead?
  5. Present the plan to the user and WAIT for confirmation before proceeding.

For detailed methodology guidance, see the research-literacy skill.

⚠️ Verification Notice

This skill was generated by AI from academic literature. All parameters, thresholds, and citations require independent verification before use in research. If you find errors, please open an issue.

Preprocessing Pipeline Overview

The standard ERP preprocessing pipeline involves 7 ordered steps. Processing order matters and can influence results (the "multiverse" problem; see Lonedo et al., 2020).

Recommended Default Order

  1. Import and inspect raw data -- Check for gross artifacts, disconnected electrodes
  2. Filter -- Apply bandpass and optional notch filter
  3. Re-reference -- Choose and apply reference scheme
  4. Bad channel identification and interpolation -- Identify and interpolate noisy channels
  5. ICA-based artifact correction -- Remove eye blinks, saccades, cardiac artifacts
  6. Epoching and baseline correction -- Segment continuous data around events
  7. Epoch rejection -- Remove remaining bad epochs by amplitude threshold

Multiverse note: Steps 2-5 interact. Filtering before ICA improves decomposition quality (Winkler et al., 2015). Some researchers re-reference after ICA. Document your choices and consider running key alternatives to assess robustness.

For detailed parameters at each step, see references/preprocessing-pipeline.md.

Key Parameter Defaults

StepParameterDefaultSource
FilterHigh-pass0.1 HzLuck, 2014, Ch. 5; Tanner et al., 2015
FilterLow-pass30 HzLuck, 2014, Ch. 5
FilterFilter typeFIR, zero-phaseWidmann et al., 2015
Re-referenceSchemeAverage referenceLuck, 2014, Ch. 5; Keil et al., 2014
Artifact rejectionThreshold+/-100 uVLuck, 2014
Bad channelsMax proportion< 10% of total channelsKeil et al., 2014
EpochingWindow-200 ms to 800 msLuck, 2014, Ch. 5
BaselineWindow-200 ms to 0 msLuck, 2014, Ch. 5

ERP Component Identification

To measure an ERP component correctly, you need three pieces of information:

  1. Latency range -- The expected time window for the component
  2. Scalp distribution -- Where on the scalp the component is maximal
  3. Functional context -- What experimental manipulation elicits the component

Component Selection Decision Logic

  1. Identify your cognitive process of interest (e.g., semantic processing, error monitoring)
  2. Look up the canonical component in references/erp-components.md
  3. Verify the component matches your paradigm -- The same voltage deflection in a different paradigm may reflect a different component (Luck, 2014, Ch. 2)
  4. Use the recommended ROI and time window as your starting point, then verify against your own grand average waveform
  5. For disputed components, read the Interpretation Notes in references/erp-components.md before committing to a theoretical interpretation

Component Domains at a Glance

DomainKey ComponentsReference File Section
Visual perceptionP1, N1, N170, N2pcerp-components.md Section 1
LanguageN400, P600/LPC, ELAN, LANerp-components.md Section 2
Executive controlERN/Ne, Pe, N2, CNVerp-components.md Section 3
MemoryFN400, parietal old/new, Dmerp-components.md Section 4

Statistical Analysis Strategy

Amplitude Measurement

Choose your measurement approach based on the component:

MeasureBest ForAvoid WhenSource
Mean amplitudeBroad components (N400, P300, LPC)Component is sharp and briefLuck, 2014, Ch. 9
Peak amplitudeSharp, well-defined peaks (P1, N1)Component has no clear peak or has multiple peaksLuck, 2014, Ch. 9
Peak latencyMeasuring processing speedComponent lacks a clear peakLuck, 2014, Ch. 9
50% fractional area latencyLatency with unequal amplitudes across conditionsRarely inappropriate; preferred over peak latencyLuck, 2014, Ch. 9; Kiesel et al., 2008
Signed/unsigned areaComponents spanning positive and negative voltagesSimple, unipolar componentsLuck, 2014, Ch. 9

Time Window and ROI Selection

  1. A priori selection (preferred): Choose time window and electrodes based on prior literature before looking at your data (Luck & Gaspelin, 2017)
  2. Collapsed localizer: Average across all conditions to identify the window/ROI, then test differences between conditions within that window (Luck & Gaspelin, 2017)
  3. Data-driven: Use mass univariate approach to avoid arbitrary window selection (see below)

Critical: Never select a time window or ROI by looking at the difference between conditions. This inflates Type I error (Luck & Gaspelin, 2017).

Choosing a Statistical Framework

Is your hypothesis about a specific, well-characterized component?
 |
 +-- YES --> Do you have a priori time window and ROI?
 | |
 | +-- YES --> Traditional ANOVA on mean/peak amplitude
 | |
 | +-- NO --> Use collapsed localizer, then ANOVA
 |
 +-- NO --> Is your effect potentially distributed across time/space?
 |
 +-- YES --> Cluster-based permutation test (Maris & Oostenveld, 2007)
 |
 +-- NO --> Mass univariate with FDR correction (Groppe et al., 2011)

For detailed statistical method descriptions, see references/statistical-approaches.md.

Common Pitfalls

  1. Double-dipping: Selecting time windows or electrodes based on the effect of interest, then testing that same effect in the selected window (Kriegeskorte et al., 2009)
  2. Excessive filtering: High-pass cutoffs above 0.1 Hz can distort slow components like the P300, N400, and LPC (Tanner et al., 2015; Widmann & Schroger, 2012)
  3. Confounding component overlap: Apparent differences in one component may be driven by overlap from an adjacent component; consider difference waves and component-specific analyses (Luck, 2014, Ch. 2)
  4. Ignoring trial count imbalance: Unequal trial counts across conditions produce differential noise levels, biasing peak amplitude and latency measures (Luck, 2014, Ch. 9)
  5. Cluster-based tests for latency: Cluster permutation tests control family-wise error but cannot localize effects to specific time points or channels (Maris & Oostenveld, 2007)
  6. Reporting only p-values: Always report effect sizes (partial eta-squared for ANOVA, Cohen's d for t-tests) alongside p-values (Keil et al., 2014)

Minimum Reporting Checklist

Based on Keil et al. (2014) and Luck (2014):

  • Number of accepted trials per condition (minimum 30 per condition recommended; Boudewyn et al., 2018)
  • Filter settings (type, cutoff frequencies, roll-off)
  • Reference scheme
  • Artifact rejection method and criteria (ICA, threshold, proportion rejected)
  • Number and identity of interpolated channels
  • Epoch window and baseline correction window
  • Component time window and ROI electrodes (with justification)
  • Amplitude measure used (mean, peak, area)
  • Statistical test, correction method, and effect sizes

References

  • Boudewyn, M. A., Luck, S. J., Farrens, J. L., & Kappenman, E. S. (2018). How many trials does it take to get a significant ERP effect? Psychophysiology, 55(6), e13049.
  • Groppe, D. M., Urbach, T. P., & Kutas, M. (2011). Mass univariate analysis of event-related brain potentials/fields I. Psychophysiology, 48(12), 1711-1725.
  • Keil, A., et al. (2014). Committee report: Publication guidelines and recommendations for studies using EEG and MEG. Psychophysiology, 51(1), 1-21.
  • Kiesel, A., Miller, J., Jolicoeur, P., & Brisson, B. (2008). Measurement of ERP latency differences. Psychophysiology, 45(4), 517-523.
  • Kriegeskorte, N., Simmons, W. K., Bellgowan, P. S., & Baker, C. I. (2009). Circular analysis in systems neuroscience. Nature Neuroscience, 12(5), 535-540.
  • Lonedo, A., et al. (2020). The multiverse of ERP analysis pipelines. NeuroImage, 209, 116465.
  • Luck, S. J. (2014). An Introduction to the Event-Related Potential Technique (2nd ed.). MIT Press.
  • Luck, S. J., & Gaspelin, N. (2017). How to get statistically significant effects in any ERP experiment (and why you shouldn't). Psychophysiology, 54(1), 146-157.
  • Maris, E., & Oostenveld, R. (2007). Nonparametric statistical testing of EEG- and MEG-data. Journal of Neuroscience Methods, 164(1), 177-190.
  • Tanner, D., Morgan-Short, K., & Luck, S. J. (2015). How inappropriate high-pass filters can produce artifactual effects. Psychophysiology, 52(8), 997-1009.
  • Widmann, A., Schroger, E., & Maess, B. (2015). Digital filter design for electrophysiological data. Journal of Neuroscience Methods, 250, 34-46.
  • Winkler, I., Debener, S., Muller, K. R., & Tangermann, M. (2015). On the influence of high-pass filtering on ICA-based artifact reduction in EEG-ERP. Proceedings of the IEEE EMBC, 4101-4105.

See references/ for detailed parameter tables, component database, and statistical method descriptions.

Frequently asked questions

What to verify before installation and use

What does the erp-analysis source document cover?

Domain-validated pipeline and parameter guidance for event-related potential analysis, from preprocessing through statistical testing

How do I install erp-analysis?

The source record exposes this install command: npx skills add https://github.com/NeuroAIHub/BrainPilot --skill "packages/skills/skills/05_EEG_ERP/erp-analysis". Inspect the command and pinned source before running it.

Alternatives

Compare before choosing

Computed 100133

JasonColapietro/suede-creator-skills

suede-ab-testing

Suede-owned experimentation discipline for hypotheses, sample sizing, test duration, significance, and repeatable experiment programs. Use when comparing variants, deciding whether a result is reliable, or building an experiment backlog and cadence. NOT FOR: analytics instrumentation (use suede-analytics), post-click conversion diagnosis (use suede-site-alchemy), or writing the variant copy itself (use suede-copy).

Computed 1008

narrative-io/narrative-skills-marketplace

design-analysis

Translate a fuzzy analytical question into a rigorous investigation plan. Interrogates the ask, grounds the plan in the available data dictionary, applies analytical best practices, and produces a structured brief of query specifications for a downstream query-writing skill. Plans, does not write SQL. Use when: "why did X drop", "is there a relationship between A and B", "who are our highest-value customers", "what's driving the change in Y", "investigate this trend", "design an analysis for", "

Computed 97779

rampstackco/claude-skills

data-warehouse-experimentation

Running experiments out of the data warehouse instead of via dedicated experiment platforms. SQL-based assignment, exposure logging discipline, metric definitions in dbt models, statistical analysis in SQL or Python, variance reduction with CUPED, sequential testing, and the operational tradeoffs vs platforms like Statsig and Optimizely. Triggers on warehouse-native experimentation, run experiments in BigQuery, run experiments in Snowflake, dbt experiments, SQL t-test, CUPED variance reduction,

Computed 9625,136

alirezarezvani/claude-skills

ab-test-setup

When the user wants to plan, design, or implement an A/B test or experiment. Also use when the user mentions "A/B test," "split test," "experiment," "test this change," "variant copy," "multivariate test," "hypothesis," "conversion experiment," "statistical significance," or "test this." For tracking implementation, see analytics-tracking.