neuroskill-bci

Connect Hermes to a NeuroSkill instance via local WebSocket/HTTP API.

Updated May 11, 2026
One-click install
npx skills add https://github.com/jason660519/Project-Manager --skill neuroskill-bci-jason660519
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: neuroskill-bci
Source: https://github.com/jason660519/Project-Manager/tree/main/hermes-agent/optional-skills/health/neuroskill-bci
Command: npx skills add https://github.com/jason660519/Project-Manager --skill neuroskill-bci-jason660519

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Hermes needs access to the user's real-time cognitive and emotional state to generate cognitively aware, context-sensitive responses. NeuroSkill BCI Integration provides a seamless connection to a NeuroSkill instance, streaming live brain and body metrics (focus, relaxation, mood, cognitive load, drowsiness, heart rate, HRV, sleep staging, and 40+ derived EXG scores) to inform Hermes' interactions and interventions. This integration supports local desktop setups with compatible BCIs (Muse 2/S or OpenBCI) and the NeuroSkill app running on the user’s machine.

Core Features & Use Cases

  • Real-time state ingestion: connect to a local NeuroSkill server and receive live scores and raw metrics over WebSocket/HTTP.
  • Session, sleep, and label analytics: retrieve per-session data, sleep staging, and timestamped labels to anchor conversations.
  • Proactive guidance and protocols: use neural and autonomic signals to suggest non-disruptive interventions or protocols from the repository, with explicit user consent.
  • Local-first, privacy-preserving: all data remains on-device; no cloud transmission beyond the local NeuroSkill server.

Quick Start

Ensure NeuroSkill desktop app is running with a connected BCI device and run the neuroskill status command to verify live metrics and begin a session.

Frequently Asked Questions about neuroskill-bci

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

FAQPage Schema
How do I integrate real-time EEG data into AI responses using a BCI device?

To integrate real-time EEG data into AI responses, connect to a local NeuroSkill server streaming live metrics from BCI devices like Muse 2/S or OpenBCI over WebSocket/HTTP. This ingests cognitive states directly into conversational outputs.

What cognitive and emotional state metrics can I monitor during a BCI session?

During a BCI session, you can monitor focus, relaxation, mood, cognitive load, drowsiness, heart rate, HRV, sleep staging, and 40+ EXG scores. These biometrics provide real-time neural and autonomic signals for state analysis.

Do I need specific hardware to stream real-time cognitive load and focus metrics?

Yes, you need a compatible BCI device like Muse 2/S or OpenBCI connected to the NeuroSkill desktop app running locally. This setup streams the raw neural and biometric data required for cognitive load ingestion.

How do I retrieve sleep staging and labeled session data from a local BCI recording?

You can retrieve sleep staging and labeled session data by running local API commands like sleep, session, and label. These commands query timestamped records stored on-device to anchor analysis.

Does this neurofeedback integration transmit raw EEG and HRV data to the cloud?

No, this neurofeedback integration is local-first and privacy-preserving, keeping all raw EEG and HRV data on-device. Data remains stored locally without any cloud transmission beyond your local NeuroSkill server.