neuroskill-bci

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

Updated Apr 18, 2026
One-click install
npx skills add https://github.com/azaanaliraza/operarius --skill neuroskill-bci-azaanaliraza
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: neuroskill-bci
Source: https://github.com/azaanaliraza/operarius/tree/main/src-tauri/bin/hermes/optional-skills/health/neuroskill-bci
Command: npx skills add https://github.com/azaanaliraza/operarius --skill neuroskill-bci-azaanaliraza

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 its 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, FAA, TBR, HRV, band powers) from a running NeuroSkill desktop app via the npx neuroskill CLI. - Session Analysis & Comparison: Break down individual sessions with first/second-half trends, compare sessions A/B with metric deltas, and search history with ANN similarity over 128-D ZUNA embeddings. - Guided Intervention Protocols: Trigger evidence-based protocols (Box Breathing, Theta-Beta Anchor, Cardiac Coherence, Power Nap) matched to specific biometric thresholds. - Use Case: You tell the assistant "I 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 tracking. ## Quick Start Ask the assistant 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 and cognitive state with NeuroSkill?▼

Run npx neuroskill status --json to get a full snapshot of live scores including focus, relaxation, mood, cognitive load, and drowsiness on a 0–1 scale. The NeuroSkill desktop app must be running with a connected BCI device for data to appear.

What hardware does NeuroSkill BCI integration support?▼

It supports Muse 2 and Muse S headbands, with OpenBCI devices supported through the desktop app, streaming 4-channel EEG at 256 Hz plus PPG and IMU data over Bluetooth. Node.js 20+ is required for the CLI.

How do I compare my focus between two sessions?▼

Run npx neuroskill compare --json to get metric deltas between the last two sessions, including absolute change, percentage change, and direction for roughly 50 metrics. You can also pass explicit UTC start and end times for custom session windows.

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 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 EEG-derived metrics are experimental and must not 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 timestamped labels, or npx neuroskill search --json for ANN similarity search over 128-D ZUNA embeddings to find neurally similar historical moments.