neuroskill-com/neuroskill-index

NeuroSkill Skill Index

NeuroSkill is a biometric AI companion powered by a real-time EEG device. It reads brainwaves and physiology continuously, and uses that data to inform every response.

NeuroSkill exposes the EEG analysis API through a local WebSocket server and HTTP tunnel. The npx neuroskill <command> CLI is the fastest way to query it from a terminal, shell script, or any automation pipeline.

Skills are loaded contextually — the LLM loads the relevant skill file into its context when the user's message matches the skill's domain.

EEG Data & API Skills

| Skill | Loaded when | Description | |---|---|---| | neuroskill-transport | transport/connection questions | WebSocket & HTTP transport, port discovery, Quick Start, output modes (--json / --full), and global CLI flags. | | neuroskill-status | status/device questions | status command — full system snapshot: device state (4 device types), signal quality, EEG scores, band powers, ratios, hooks summary, embeddings, labels, sleep summary, and recording history. | | neuroskill-sessions | session/history questions | session and sessions commands — per-session metric breakdowns with first/second-half trends, session listing, and Unix timestamp helpers. | | neuroskill-search | comparison/trend questions | search and compare commands — ANN search for neurally similar EEG moments across all history, and A/B session comparison with metric deltas and UMAP enqueuing. | | neuroskill-sleep | sleep/fatigue context | sleep and umap commands — EEG-based sleep stage classification (Wake/N1/N2/N3/REM) with efficiency and bout analysis, and 3D UMAP projection for spatial session comparison. | | neuroskill-labels | label/search context | label, search-labels, and interactive commands — creating EEG text annotations, semantic vector search over labels, and cross-modal 5-layer graph search combining text, EEG similarity, and screenshot discovery with 3D visualization. | | neuroskill-streaming | streaming/calibration/TTS context | say, listen, notify, calibrate, calibrations, timer, and raw commands — on-device TTS speech, real-time WebSocket event streaming, OS notifications, calibration profile management, focus timer, and raw JSON passthrough. | | neuroskill-hooks | hooks/automation context | hooks command — Proactive Hooks CRUD, real-time EEG pattern matching with scenario gating (cognitive/emotional/physical), threshold suggestions, WebSocket broadcast triggers, and audit logging. | | neuroskill-terminal | terminal/shell/command tracking | terminal command — OS-wide shell hook management (install/uninstall/status for zsh/bash/fish/PowerShell), tracked terminal commands, brain-fused terminal impact analysis, dev loop detection, context switch cost. | | neuroskill-dnd | DND/focus-mode context | dnd command — EEG-driven Do Not Disturb automation, rolling focus score average, OS-level DND state, and force-override on/off. | | neuroskill-calendar | calendar/schedule/meetings/events questions | calendar command — OS calendar events via EventKit (macOS), iCal files (Linux/Windows); fetch by range, check access status, request permission. | | neuroskill-screenshots | screenshot/OCR/vision search context | search-images, screenshots-around, screenshots-for-eeg, and eeg-for-screenshots commands — search screenshots by OCR text (semantic or substring), by visual similarity (CLIP --by-image), find screenshots near a timestamp or EEG session, and cross-modal EEG↔screenshot bridging (find brain state for screen content, or screen content for brain state). | | neuroskill-data-reference | metric field questions | All metric fields — band powers, EEG ratios and indices, core scores, complexity measures, PPG/HRV, motion and artifact markers, sleep stage codes, neurological indices, and consciousness metrics. | | neuroskill-recipes | scripting/automation questions | Use-case recipes and scripting patterns — focus monitoring, stress tracking, sleep analysis, cognitive load queries, meditation tracking, cross-modal graph search, A/B comparison, time-range queries, and automation with cron/Python/Node.js/HTTP. |

LLM & AI Skills

| Skill | Loaded when | Description | |---|---|---| | neuroskill-llm | LLM/chat/model questions | Built-in on-device LLM inference server — model catalog management (add/download/select/delete GGUF models), vision support (mmproj), streaming WebSocket and HTTP chat, automatic tool calling, GenParams tuning, persistent chat history, and OpenAI-compatible API. |

Protocol & Intervention Skills

| Skill | Loaded when | Description | |---|---|---| | neuroskill-evidence | any intervention, protocol, habit tracking, or "what works for me?" question | Implicit evidence collection and personal effectiveness engine — standardised px: label schema, automatic before/after measurement, outcome scoring, personal protocol ranking, life-event tracking, evidence-driven selection rules, and privacy safeguards. All other skills that deliver interventions MUST follow this skill's rules. | | neuroskill-protocols | any protocol/exercise/routine intent detected | Protocol framework hub — personalisation engine, API integration guide, modality router, matching guidance, and index of 11 domain sub-skills. Always loaded alongside domain sub-skills. | | neuroskill-protocols-focus | focus, attention, cognitive load, energy, alertness, flow, creativity | Focus, attention, cognition, consciousness, and energy/alertness protocols. | | neuroskill-protocols-meditation | meditation, mantra, visualization, loving-kindness, body scan, open awareness, neurofeedback meditation | Meditation protocols — focused attention, open monitoring, mantra, visualization, loving-kindness, body scan, walking meditation, and EEG-biofeedback meditation. | | neuroskill-protocols-mindfulness | mindfulness, present-moment awareness, noting, RAIN, STOP, grounding, urge surfing, mindful eating, thought defusion | Mindfulness protocols — noting, mindful breathing/eating/walking/listening, STOP, RAIN, 5-4-3-2-1 grounding, thought defusion, self-compassion, equanimity, and urge surfing. | | neuroskill-protocols-stress | stress, anxiety, relaxation, HRV, calm, overwhelm, breathing exercises | Stress, relaxation, autonomic regulation, HRV, hemispheric balance, and deep relaxation protocols. | | neuroskill-protocols-emotions | emotions, mood, anger, grief, sadness, shame, fear, loneliness, joy | Emotional regulation, mood, and extended emotional processing protocols (12 specific emotions). | | neuroskill-protocols-sleep | sleep, insomnia, nap, rest, recovery, NSDR, tired | Sleep, circadian, recovery, NSDR/yoga nidra, and power nap protocols. | | neuroskill-protocols-body | body, tension, neck, headache, eye strain, posture, pain, grounding | Body, somatic, neck/cervical, eye exercise, headache/migraine, and motor protocols. | | neuroskill-protocols-routines | morning routine, gym, workout, exercise, hydration, break | Morning routines, workout/gym, hydration, and movement break protocols. | | neuroskill-protocols-nutrition | food, diet, nutrition, caffeine, fasting, meal, cravings, alcohol | Dietary, nutrition, caffeine timing, fasting, eating, and gut-brain protocols. | | neuroskill-protocols-music | music, playlist, listening, binaural beats, singing | Music protocols — genre/BPM/artist suggestions for mood, focus, stress, sleep, and emotional release. | | neuroskill-protocols-digital | social media, phone, screen time, scrolling, digital detox, FOMO | Social media, digital addiction, screen time, and attention restoration protocols. | | neuroskill-protocols-breathfree | non-breathing, breath-free, alternative, tactile, fidget, cold water | 30+ non-breathing alternatives — cognitive, tactile, oculomotor, micro-movement, auditory, and passive physiological. | | neuroskill-protocols-life | parent, elderly, teen, student, ADHD, autism, commute, shift work, relationship, disability, cultural | Context-specific protocols for 11 life situations — parenting, aging, teens, neurodivergent, commuters, manual workers, healthcare, relational, accessibility, cultural, and situational. |

Tools Available to the LLM

The built-in LLM chat has access to these tools (enabled in Settings > LLM > Tools):

| Tool | Purpose | |---|---| | date | Get current date/time metadata (Unix timestamps, timezone, local/UTC). | | location | Approximate public-IP geolocation (country/region/city/timezone). | | bash | Execute shell commands and return stdout/stderr. | | read_file | Read file contents from disk. | | write_file | Write / create files. | | edit_file | Surgical find-and-replace edits in files. | | search_output | Navigate large tool outputs (paginated regex/head/tail). | | web_search | Search the web and return results. | | web_fetch | Fetch a URL and return its content. | | skill | Query the NeuroSkill EEG API (status, sessions, labels, search, hooks, DND, calibrations, TTS, etc.). |

How Skill Loading Works

Skills are discovered automatically from:

1. ~/.skill/skills/ — user-global skills
2. <project>/.skill/skills/ — project-local skills
3. The bundled skills/ directory (this repository)

Each skill has a SKILL.md with YAML frontmatter (name, description). On LLM server startup, all skills are discovered and their names/descriptions are injected into the system prompt as an <available_skills> XML block. When the user's task matches a skill's description, the LLM uses the read_file tool to load the full instructions from the SKILL.md file.