neuroskill-bci

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

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

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 responses can incorporate 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 via npx neuroskill status --json and translate metrics into natural-language insights with interpretation thresholds. - Session & Sleep Analysis: Break down individual sessions with first/second-half trends, compare sessions A/B across ~50 metrics, and review epoch-by-epoch 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 flow states or stress moments. - Guided Protocols: Suggest evidence-based interventions (box breathing, cardiac coherence, mind dumps) triggered by specific biometric signals, while protecting flow state from interruption. - Use Case: A user says "I can't concentrate." The agent checks live metrics, confirms elevated theta and TBR > 1.5, then offers a 90-second Theta-Beta Neurofeedback Anchor and labels the moment for later tracking. ## Quick Start Ask the agent to check your current cognitive state by running npx neuroskill status --json 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 and cognitive state with NeuroSkill?▼

Run npx neuroskill status --json to get a full system snapshot including focus, relaxation, mood, cognitive load, and drowsiness scores on a 0–1 scale. Always use the --json flag for reliable parsing, and interpret metrics against thresholds like focus > 0.70 for flow state.

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.

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/end ranges with --a-start, --a-end, --b-start, and --b-end. The response includes metric deltas, percentage changes, and improved/declined insight arrays for roughly 50 metrics.

Why does npx neuroskill status hang or return zeros?▼

Hanging usually means the NeuroSkill desktop app is not running, while all-zero scores indicate poor electrode contact. Open the app, verify the device is connected via Bluetooth, and check that per-electrode signal_quality values are 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. Its metrics come from consumer-grade hardware 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 and AASM heuristics. The analysis reports efficiency, onset latency, and REM latency against healthy adult targets.