neuroskill-bci

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? It connects an AI assistant to a running NeuroSkill desktop instance 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—captured from a BCI wearable. ## Core Features & Use Cases - Live State Monitoring: Query 40+ derived EXG scores (focus, TBR, FAA, HRV, band powers) via the npx neuroskill CLI and interpret them in natural language. - Session & Sleep Analysis: Break down individual sessions with first/second-half trends, compare sessions A/B, and review epoch-level sleep staging against healthy targets. - Guided Interventions: Suggest evidence-based protocols (box breathing, theta-beta anchoring, NSDR) triggered by specific metric thresholds, and label key moments for later semantic search. - Use Case: A user says "I can't concentrate." The assistant checks live metrics, confirms elevated theta and TBR > 1.5, then offers a 90-second Theta-Beta Neurofeedback Anchor and re-checks metrics afterward. ## Quick Start Ask the assistant to check your current cognitive state using NeuroSkill and interpret your focus, relaxation, and heart rate 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 cognitive state with NeuroSkill?

Run npx neuroskill status --json to get a full snapshot of live metrics including focus, relaxation, cognitive load, drowsiness, heart rate, and EEG band powers. The NeuroSkill desktop app must be running with a connected BCI device.

What hardware does NeuroSkill BCI integration require?

It requires a Muse 2, Muse S, or OpenBCI headset streaming 4-channel EEG plus PPG and IMU over Bluetooth, the NeuroSkill desktop app running locally, and Node.js 20 or later for the npx neuroskill CLI.

Can NeuroSkill metrics be used for medical diagnosis?

No. NeuroSkill is an open-source research tool that is not FDA or CE cleared. Its metrics come from consumer-grade hardware and must never be used for clinical diagnosis or treatment decisions.

Why does npx neuroskill status return zeros or hang?

Hanging usually means the NeuroSkill desktop app is not running. All-zero scores indicate poor electrode contact—reposition the headband, moisten electrodes, and check that per-electrode signal quality is at least 0.7.

How do I compare my focus between two work sessions?

Run npx neuroskill compare --json to get metric deltas between the last two sessions, including percentage changes, improved and declined metrics, and sleep summaries. Custom time ranges can be set with --a-start/--a-end and --b-start/--b-end flags.

How does NeuroSkill sleep staging work?

It classifies 5-second epochs into Wake, N1, N2, N3, and REM using relative band-power ratios and AASM heuristics. Run npx neuroskill sleep --json to get efficiency, onset latency, and stage percentages compared against healthy targets.