neuroskill-bci

Translate real-time NeuroSkill BCI EEG/PPG metrics into user-facing guidance.

Updated May 4, 2026
One-click install
npx skills add https://github.com/JamesFincher/gengar --skill neuroskill-bci-jamesfincher
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: neuroskill-bci
Source: https://github.com/JamesFincher/gengar/tree/main/optional-skills/health/neuroskill-bci
Command: npx skills add https://github.com/JamesFincher/gengar --skill neuroskill-bci-jamesfincher

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps translate real-time NeuroSkill BCI metrics (focus, relaxation, mood, cognitive load, drowsiness, HR/HRV, sleep staging, and derived EXG scores) into practical, state-aware guidance so your responses adapt to what you are experiencing right now.

Core Features & Use Cases

  • Live cognitive & emotional state awareness: Connect to a running NeuroSkill instance and interpret current metrics into meaningful natural-language context for the user.
  • Session, trends, and comparisons: Analyze single-session evolution, list history, and compare A/B sessions to explain what changed and why it matters.
  • Historical retrieval and labeling: Use neural similarity search, semantic label search, and cross-modal graph search to find past moments like the current state and surface what was happening then.
  • Sleep & recovery insight: Retrieve sleep staging and summary metrics to support recovery planning using research-only guidance.
  • Safety-first protocol suggestions: Recommend guided interventions from the provided protocol references when metrics cross defined thresholds, always with user consent and research-only framing.

Quick Start

Use the neuroskill-bci skill to read your live NeuroSkill metrics and get a state-aware interpretation of how you are doing right now.

Frequently Asked Questions about neuroskill-bci

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

FAQPage Schema
How do I use real-time BCI EEG metrics to adapt conversation responses?▼

Real-time BCI EEG metrics adapt conversation responses by connecting to a running NeuroSkill instance via WebSocket or HTTP API, parsing JSON fields like scores and signal_quality, and translating cognitive states into state-aware user guidance.

What is neurofeedback-based sleep staging and how does it support recovery planning?▼

Neurofeedback-based sleep staging retrieves sleep epochs and summary metrics from PPG and EEG data to support recovery planning, providing research-only guidance on sleep quality and physiological recovery patterns.

Do I need a local NeuroSkill instance running to access live HRV and cognitive load metrics?▼

Yes, accessing live HRV and cognitive load metrics requires a running local NeuroSkill instance accessible via its WebSocket or HTTP API, typically on port 8375, to parse real-time EXG scores and embeddings.

How do I compare historical BCI sessions to explain changes in focus and relaxation trends?▼

Comparing historical BCI sessions involves analyzing single-session evolution and using neural similarity search with semantic label retrieval to find past moments matching current focus and relaxation states, explaining what changed and why.

Can I trigger safety-first guided interventions when cognitive load or drowsiness crosses defined thresholds?▼

Yes, guided interventions are recommended from provided protocol references when cognitive load or drowsiness metrics cross defined thresholds, always requiring user consent and framed with research-only guidance.

How does neural similarity search work for retrieving past brain state labels and embeddings?▼

Neural similarity search retrieves past brain state labels and embeddings by performing cross-modal graph search and semantic label search to find historical moments matching current cognitive and emotional metrics.