neuroskill-bci

Reads real-time EEG and biometric metrics from a NeuroSkill BCI session to inform responses.

1|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/kaminocorp/hermes-alpha-hunter --skill neuroskill-bci-kaminocorp
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: neuroskill-bci
Source: https://github.com/kaminocorp/hermes-alpha-hunter/tree/main/optional-skills/health/neuroskill-bci
Command: npx skills add https://github.com/kaminocorp/hermes-alpha-hunter --skill neuroskill-bci-kaminocorp

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? It connects an AI assistant to a running NeuroSkill desktop app so responses can account for the user's live cognitive and emotional state — focus, relaxation, mood, cognitive load, drowsiness, heart rate, HRV, and sleep staging — instead of guessing how the user is feeling. ## Core Features & Use Cases - Live State Monitoring: Query 40+ EXG-derived scores via npx neuroskill status --json and interpret them with threshold-based guidance (flow state, fatigue, stress). - Session History & Comparison: Analyze single sessions with first/second-half trends, run A/B comparisons across days, and search neurally similar moments using ZUNA embeddings and ANN search. - Sleep Analysis: Retrieve epoch-by-epoch sleep staging (Wake/N1/N2/N3/REM) with efficiency and latency metrics compared against healthy targets. - Guided Interventions: Suggest from 70+ metric-triggered protocols (box breathing, cardiac coherence, mind dumps, power naps) when thresholds indicate a need. - Use Case: A user says "I can't concentrate." The assistant checks live metrics, confirms elevated TBR and low focus, then offers a 90-second Theta-Beta Neurofeedback Anchor and labels the moment for later tracking. ## Quick Start Ask the assistant to check your current cognitive state using NeuroSkill and interpret your focus, relaxation, and mood metrics.

Frequently Asked Questions about neuroskill-bci

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

FAQPage Schema
How do I check my real-time focus and brain metrics with NeuroSkill?▼

Run npx neuroskill status --json to get a full snapshot of live scores including focus, relaxation, mood, cognitive load, and drowsiness. The NeuroSkill desktop app must be running with a connected BCI device for data to appear.

What BCI hardware does NeuroSkill support?▼

NeuroSkill is validated for Muse 2 and Muse S headbands, with OpenBCI support in the desktop app. It streams 4-channel EEG at 256 Hz plus PPG and IMU data over Bluetooth Low Energy.

Can NeuroSkill metrics be used for medical diagnosis?▼

No. NeuroSkill is an open-source research tool and is not FDA or CE cleared. Its metrics are experimental and must never be used for clinical diagnosis or treatment decisions.

Why does npx neuroskill status return zeros or fail?▼

Zero scores usually mean poor electrode contact — reposition the headband and moisten the electrodes. If the command hangs, the desktop app is not running; if npx is not found, install Node.js 20 or later.

How do I compare my focus between two sessions?▼

Run npx neuroskill compare --json to automatically compare the last two sessions, or pass explicit UTC start and end times for sessions A and B. The output includes metric deltas, percentage changes, and improved/declined insight arrays.

Does NeuroSkill send my brain data to external servers?▼

No. All data stays local in a SQLite database and HNSW index under ~/.skill/YYYYMMDD/. The server runs on localhost port 8375 and nothing is transmitted externally.