neuroskill-bci

Integrates a voice-first agent with NeuroSkill to condition responses on real-time BCI metrics.

Updated Apr 9, 2026
One-click install
npx skills add https://github.com/MarbleSodas/Mavis --skill neuroskill-bci-marblesodas
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: neuroskill-bci
Source: https://github.com/MarbleSodas/Mavis/tree/main/optional-skills/health/neuroskill-bci
Command: npx skills add https://github.com/MarbleSodas/Mavis --skill neuroskill-bci-marblesodas

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It enables a voice-first agent to adapt its responses to your real-time cognitive and emotional signals from a BCI, so guidance matches what your brain and body are doing right now.

Core Features & Use Cases

  • Real-time state-aware responses: Incorporates focus, relaxation, mood, cognitive load, drowsiness, heart rate, HRV/coherence, and sleep staging into conversational guidance.
  • Neuro-metrics interpretation & thresholds: Translates raw scores into meaningful language and actionable context (e.g., flow protection, fatigue warnings, stress interventions).
  • History-based insight: Uses neural similarity search, label search, comparisons, and session trends to answer questions like “When was I last in a flow state?” and “How did today differ from yesterday?”
  • Protocol suggestions for detected states: Selects and explains an appropriate guided protocol based on the most salient biometric signal, while asking for permission before starting.

Quick Start

Ask the agent to connect to your local NeuroSkill instance and then summarize your current focus, relaxation, mood, cognitive load, and drowsiness in plain language using the live metrics stream.

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 EEG and cognitive state data to condition AI responses?

Real-time cognitive load and sleep staging data adapts AI guidance by integrating a voice-first agent with a local BCI instance, obtaining structured signals via WebSocket or HTTP APIs to condition responses on current neural and emotional metrics.

What BCI hardware and software do I need for neurofeedback-guided coaching?

Neurofeedback-guided coaching requires a compatible BCI device and the NeuroSkill desktop app running locally to stream structured cognitive, emotional, and heart rate metrics to the voice-first agent.

Can I search my historical EEG data to find when I was in a flow state?

You can search historical EEG data to find flow states using neural similarity search and semantic label retrieval to query past session trends and compare cognitive metrics like focus and relaxation across different time periods.

How does real-time biometric monitoring handle fatigue warnings and stress interventions?

Real-time biometric monitoring handles fatigue warnings and stress interventions by translating raw EEG and HRV scores into actionable context, triggering protocol suggestions to protect flow or reduce stress based on detected states.

Does this brain-computer interface integration work for sleep staging analysis?

This brain-computer interface integration supports sleep staging analysis by incorporating sleep staging context into conversational guidance and using historical session trends for personalized coaching based on research-only safety framing.

What are the limitations of using BCI-derived cognitive metrics for personalized coaching?

Limitations of using BCI-derived cognitive metrics include enforcement of research-only safety framing and the requirement for a locally running NeuroSkill instance, ensuring biometric data interpretation remains within non-clinical research contexts.