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.