neuroskill-bci

Reads real-time EEG and biometric metrics from a NeuroSkill BCI wearable via CLI commands.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? It lets an AI assistant incorporate your live cognitive and emotional state — focus, relaxation, mood, cognitive load, drowsiness, heart rate, and sleep staging — into responses, so advice and interventions are grounded in actual biometric data rather than guesswork. ## Core Features & Use Cases - Live State Monitoring: Query 40+ derived EXG scores (focus, TBR, FAA, HRV, band powers) from a Muse 2/S or OpenBCI headset through the npx neuroskill CLI. - Session Analysis & History: Break down individual sessions, compare A/B sessions with metric deltas, and run ANN similarity or semantic label searches over past neural states. - Guided Interventions: Suggest evidence-based protocols (box breathing, cardiac coherence, mind dumps, power naps) triggered by specific metric thresholds, with sleep staging analysis for recovery tracking. - Use Case: You tell the assistant you can't concentrate. It runs npx neuroskill status --json, confirms elevated theta and TBR > 1.5, then walks you through a 90-second Theta-Beta Neurofeedback Anchor and labels the moment for later review. ## Quick Start Ask the assistant to check how you are doing right now so it runs a NeuroSkill status check and interprets your current focus, relaxation, and mood 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 current focus level with a Muse headband?▼

Run `npx neuroskill status --json` with the NeuroSkill desktop app running and your Muse 2/S connected via Bluetooth. The response includes a focus score from 0 to 1, where values above 0.70 indicate flow-state concentration.

What BCI devices work with NeuroSkill?▼

NeuroSkill supports the Muse 2 and Muse S headbands, with OpenBCI support available 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 my focus between two work sessions?▼

Run `npx neuroskill compare --json` to automatically compare your last two sessions. It returns metric deltas with percentage changes, lists of improved and declined metrics, and sleep staging for both sessions.

Why does NeuroSkill 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 per-electrode signal quality values are at least 0.7 in the status output.

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.

Does NeuroSkill send my brain data to external servers?▼

No. All data is stored locally in a SQLite database with an HNSW index under ~/.skill/YYYYMMDD/. The server runs on localhost port 8375 and nothing is transmitted externally.