neuroskill-bci

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

14|5|Updated Apr 9, 2026
One-click install
npx skills add https://github.com/MLT-OSS/hermes-agent-go --skill neuroskill-bci-mlt-oss
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: neuroskill-bci
Source: https://github.com/MLT-OSS/hermes-agent-go/tree/main/optional-skills/health/neuroskill-bci
Command: npx skills add https://github.com/MLT-OSS/hermes-agent-go --skill neuroskill-bci-mlt-oss

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 it can read the user's live cognitive and physiological state (focus, relaxation, mood, cognitive load, drowsiness, heart rate, HRV, sleep staging) from a BCI wearable and adapt responses, suggest interventions, and track mental performance over time. ## Core Features & Use Cases - Live State Monitoring: Query 40+ EXG-derived scores via the npx neuroskill CLI and interpret them in natural language with threshold-based guidance. - Session & Sleep Analysis: Break down individual sessions with first/second-half trends, compare sessions A/B, and analyze sleep staging against healthy targets. - Historical Search & Labeling: Run ANN similarity search over 128-D ZUNA embeddings, semantic label search, and cross-modal graph search to find past mental states. - Guided Protocols: Suggest evidence-based interventions (box breathing, cardiac coherence, mind dumps, power naps) matched to specific metric triggers. - Use Case: A user says "I can't concentrate" — the assistant checks live metrics, confirms elevated theta and TBR, then walks the user through 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 by running npx neuroskill status and interpreting your 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 real-time focus and cognitive state with NeuroSkill?

Run npx neuroskill status --json to get a full snapshot of live scores including focus, relaxation, engagement, mood, cognitive load, and drowsiness. The JSON output also includes device state, signal quality per electrode, and heart rate from PPG.

What hardware does NeuroSkill BCI integration require?

It requires a Muse 2, Muse S, or OpenBCI headset streaming EEG plus PPG and IMU data over Bluetooth, the NeuroSkill desktop app running locally, and Node.js 20 or later for the npx neuroskill CLI. Signal quality should be at least 0.7 per electrode.

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 response includes metric deltas with percentage changes plus improved and declined metric lists.

Why does npx neuroskill status return all zero scores?

All-zero scores usually indicate poor electrode contact on the headband. Reposition the device, moisten the electrode contacts, and check that signal_quality values are at least 0.7 and SNR is above 3 dB before trusting the metrics.

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. Its EEG-derived metrics come from consumer-grade hardware and must never be used for clinical diagnosis or treatment decisions.

How do I find past moments when I was in a flow state?

Use npx neuroskill search-labels "flow" --json for semantic search over your labels, or npx neuroskill search --json for ANN similarity search over 128-D ZUNA embeddings to find neurally similar historical moments with timestamps and metrics.