neuroskill-bci

Reads live EEG cognitive metrics from a NeuroSkill BCI wearable via CLI commands.

Updated Sep 10, 2026
One-click install
npx skills add https://github.com/loteiron/ZeusAgent --skill neuroskill-bci-loteiron
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: neuroskill-bci
Source: https://github.com/loteiron/ZeusAgent/tree/main/optional-skills/health/neuroskill-bci
Command: npx skills add https://github.com/loteiron/ZeusAgent --skill neuroskill-bci-loteiron

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? It connects an AI agent to a running NeuroSkill 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 based on biometric signals. ## 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 & Comparison: Break down individual sessions with first/second half trends, 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 specific biometric thresholds. - Use Case: A user says "I can't concentrate." The agent runs npx neuroskill status --json, confirms elevated theta and TBR above 1.5, then suggests a 90-second Theta-Beta Neurofeedback Anchor and labels the moment for later retrieval. ## Quick Start Ask the agent to check your current cognitive state by running npx neuroskill status and interpreting the focus, relaxation, and mood scores in plain language.

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 snapshot of live metrics including focus, relaxation, engagement, and heart rate. Focus above 0.70 indicates flow-state territory, while below 0.40 suggests distraction or fatigue.

How to compare brain metrics between two sessions?▼

Use npx neuroskill compare --json to automatically compare the last two sessions, or pass explicit UTC start and end ranges. It returns metric deltas with percentage changes plus improved and declined metric lists across roughly 50 metrics.

What BCI devices 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.

Why does npx neuroskill status return all zero scores?▼

Zero scores usually indicate poor electrode contact on the headband. Reposition the device, moisten the electrode contacts, and check that per-electrode signal_quality values are at least 0.7 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 metrics are experimental and must never be used for clinical diagnosis or treatment decisions.

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 reports efficiency, onset latency, and REM latency against healthy adult targets.