neuroskill-bci

Connect to NeuroSkill instances and ingest real-time EEG and biometric scores.

Updated Mar 25, 2026
One-click install
npx skills add https://github.com/afel6/scal-ai-pipeline --skill neuroskill-bci-afel6
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: neuroskill-bci
Source: https://github.com/afel6/scal-ai-pipeline/tree/main/hermes_skills_library/optional-skills/health/neuroskill-bci
Command: npx skills add https://github.com/afel6/scal-ai-pipeline --skill neuroskill-bci-afel6

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

NeuroSkill BCI Integration lets an agent understand a user's moment-to-moment cognitive and physiological state so the assistant can provide context-aware guidance, interventions, and session analysis without manual interpretation of raw EEG/PPG data.

Core Features & Use Cases

  • Live cognitive summaries: Parse real-time scores (focus, relaxation, engagement, drowsiness, HR, HRV, FAA, TBR, etc.) and translate them into actionable natural-language insights.
  • Session analytics & comparisons: Load session breakdowns, trends, and A/B comparisons to explain how mental state evolved and what changed between sessions.
  • Protocol recommendation & guided exercises: Suggest and guide brief evidence-informed protocols (breathing, neurofeedback anchors, vagal toning, naps) based on metric triggers and confirm before starting.
  • Historical search & visualization: Perform neural similarity searches and UMAP visualizations to find past moments with matching brain states and support longitudinal tracking.
  • Local-first privacy & safe operation: Designed to work with a locally running NeuroSkill desktop app and BCI hardware, keeping data on-device and requiring explicit permission before interventions.

Quick Start

Run npx neuroskill status --json and ask the assistant to summarize your current focus, relaxation, and any recommended protocol.

Frequently Asked Questions about neuroskill-bci

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I monitor real-time EEG and biometric data from a BCI device?

Real-time EEG and biometric monitoring requires connecting to a running NeuroSkill desktop app instance via a localhost JSON/WebSocket API, which streams scores for focus, relaxation, HR, and HRV directly to the assistant for cognitive summarization.

What BCI hardware is supported for live brain-state awareness and neurofeedback?

Supported BCI hardware for live brain-state awareness includes Muse 2, Muse S, and OpenBCI devices. These devices connect to the local NeuroSkill desktop app to stream EEG and PPG data for real-time cognitive analysis.

Can I compare past EEG session trends to analyze cognitive performance?

Comparing past EEG session trends is possible by loading session breakdowns and A/B comparisons from the local NeuroSkill app, allowing the assistant to explain how mental states evolved and what metrics changed between sessions.

Do I need a local NeuroSkill desktop app to use real-time biometric scoring?

Yes, a local NeuroSkill desktop app is required for real-time biometric scoring. The app manages the BCI device connection and exposes the localhost WebSocket API needed to stream focus, relaxation, and engagement metrics to the assistant.

How does neural similarity search work for finding matching brain states?

Neural similarity search performs historical lookups by matching current EEG patterns against past sessions, using UMAP visualizations to find moments with similar brain states and supporting longitudinal tracking for personal research.

What are the limitations of using BCI data for guided neurofeedback interventions?

A key limitation is that all guided neurofeedback interventions require explicit user permission before starting. Additionally, the system operates strictly locally, meaning data cannot be accessed without the desktop app and supported BCI hardware actively running.