neuroskill-bci

Reads live EEG cognitive metrics from NeuroSkill via CLI and WebSocket API.

Updated Aug 22, 2026
One-click install
npx skills add https://github.com/vivekgoquest/hermes-agent-stable --skill neuroskill-bci-vivekgoquest
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: neuroskill-bci
Source: https://github.com/vivekgoquest/hermes-agent-stable/tree/main/optional-skills/health/neuroskill-bci
Command: npx skills add https://github.com/vivekgoquest/hermes-agent-stable --skill neuroskill-bci-vivekgoquest

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? It connects an AI agent to a running NeuroSkill desktop instance so users can query real-time brain and body metrics from a BCI wearable, interpret cognitive states like focus and drowsiness, and receive guided intervention protocols. ## Core Features & Use Cases - Live Cognitive State Monitoring: Query focus, relaxation, engagement, mood, cognitive load, heart rate, and EEG band ratios through the npx neuroskill CLI with JSON output. - Session Analysis & History: Break down individual sessions with trend detection, compare sessions A/B across ~50 metrics, and search history with ANN similarity over 128-D ZUNA embeddings. - Sleep Staging & Protocols: Retrieve epoch-by-epoch sleep classification (Wake/N1/N2/N3/REM) and trigger over 70 guided mind-body protocols matched to biometric signals. - Use Case: A user wearing a Muse 2 headband asks "How am I doing right now?" — the agent runs npx neuroskill status --json, interprets the scores in natural language, and suggests a Box Breathing protocol if stress indicators are elevated. ## Quick Start Ask the agent to check your current cognitive state by running npx neuroskill status with JSON output and interpreting the focus, relaxation, and mood scores.

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 current focus level with NeuroSkill?▼

Run npx neuroskill status --json to get a full system snapshot including focus, relaxation, engagement, and mood scores on a 0-1 scale. Focus above 0.70 indicates flow-state territory, while below 0.40 suggests distraction or fatigue.

What BCI devices work with NeuroSkill?▼

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.

How do I compare 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. It returns metric deltas with percentage changes plus improved and declined metric lists.

Why does npx neuroskill status hang or return zeros?▼

Hanging usually means the NeuroSkill desktop app is not running, while zero scores indicate poor electrode contact. Open the app, verify Bluetooth connection, and check that per-electrode signal quality is at least 0.7.

Can NeuroSkill metrics be used for medical diagnosis?▼

No. NeuroSkill is an open-source research tool that has not been cleared by the FDA, CE, or any regulatory body. All metrics are experimental and derived from consumer-grade hardware, so they must not be used for clinical diagnosis or treatment.

How does NeuroSkill sleep staging work?▼

Run npx neuroskill sleep --json to get epoch-by-epoch staging in 5-second windows classified as Wake, N1, N2, N3, or REM using band-power ratios. The analysis includes efficiency percentage, onset latency, and healthy targets like N3 at 15-25% of total sleep.