skills

Skill index and overview — lists all available NeuroSkill skills, tools, and explains how skill loading works.

NeuroSkill activity tracking — file interactions, terminal commands, focus sessions, meetings, clipboard, productivity scoring, weekly digest, brain awareness, and multi-monitor awareness. Tracks files, terminal commands (50+ categories), dev loops, zone switches, EEG-correlated struggle prediction, and task type detection. Use when asking about coding activity, file history, productivity, meetings, terminal usage, dev workflow, or brain state.

NeuroSkill Do Not Disturb automation — EEG-driven focus detection that activates OS-level DND and optional grayscale display when sustained attention exceeds a threshold. Shows rolling average, sample window, and OS state. Supports force-override on/off. Use when managing focus-based DND automation, grayscale mode, or checking DND status.

Meditation protocols — guided, unguided, mantra, visualization, loving-kindness, body scan, open awareness, and EEG-biofeedback meditation with real-time neural tracking.

Mindfulness protocols — present-moment awareness, informal mindfulness, mindful eating, mindful listening, RAIN, STOP, noting practice, and EEG-tracked mindfulness with real-time neural feedback.

NeuroSkill `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. Use when annotating EEG moments or searching for past states by description.

NeuroSkill built-in LLM inference server — on-device OpenAI-compatible chat with llama.cpp, model catalog management (add/download/select/delete GGUF models), vision support (mmproj), streaming WebSocket and HTTP chat, automatic tool calling (bash, read, write, edit, web_search, web_fetch), GenParams tuning, and persistent chat history. Use when managing local LLM models, chatting, or integrating with the OpenAI-compatible API.

NeuroSkill screenshot search commands — `search-images` for OCR text and CLIP vision search, `screenshots-around` for temporal proximity, `screenshots-for-eeg` for finding what was on screen during EEG sessions, and `eeg-for-screenshots` for discovering brain state near matching screenshots. Cross-modal EEG↔screenshot bridging. Use when searching for past screen content, correlating screen activity with brain states, or exploring screenshot history.

NeuroSkill `search` and `compare` commands — ANN search for neurally similar EEG moments across all history, and A/B session comparison with metric deltas, trend directions, and UMAP enqueuing. Use when finding similar past brain states or comparing two recording sessions.

Implicit evidence collection, personal effectiveness tracking, and data-driven recommendation engine for NeuroSkill. Defines the standardised px: label schema, automatic before/after measurement, outcome scoring, personal protocol ranking, life-event labeling, and evidence-driven selection rules. Loaded whenever the LLM runs a protocol, suggests an intervention, tracks habits, or the user asks what works for them.

NeuroSkill calendar integration — fetch OS calendar events (macOS EventKit, Linux iCal files, Windows Outlook/Calendar). Shows today's meetings, upcoming events, and access status. Use when the user asks about their schedule, meetings, events, appointments, or what they have coming up.

Body, somatic, neck, eye, headache, and motor protocols — interventions for physical tension, headache_index, migraine_index, stillness, mu_suppression, eye strain, and spectral_centroid.

Non-breathing alternative protocols — cognitive, tactile, oculomotor, micro-movement, auditory, and passive physiological interventions for users who find breathwork inconvenient, uncomfortable, or inaccessible.

Social media, digital addiction, screen time, and attention restoration protocols — interventions for doom-scrolling, phone compulsion, FOMO, comparison, dopamine reset, and digital sunset.

Emotional regulation, mood, and extended emotional processing protocols — interventions for faa, mood, anger, grief, shame, fear, envy, joy, loneliness, resentment, excitement, and emotional boundaries.

Focus, attention, cognition, consciousness, deep meditation, and energy/alertness protocols — EEG-triggered interventions for tbr, focus, engagement, cognitive_load, lzc, wakefulness, apf, and pac_theta_gamma.

Context-specific and life-stage protocols — parenting/caregiving, elderly/aging, teens/students, neurodivergent (ADHD, autism, OCD), commuters, manual/physical workers, healthcare/shift workers, intimate/relational, accessibility-adapted, culturally diverse practices, and situational micro-protocols.

Music protocols — genre, BPM, artist suggestions, and listening techniques for mood regulation, focus, stress discharge, sleep, binaural beats, singing, and emotional release through music.

Dietary, nutrition, caffeine, fasting, and eating protocols — EEG-correlated food guidance for focus, mood, blood sugar, sleep, gut-brain axis, cravings, and alcohol awareness.

Morning routines, workout/gym, hydration, bathroom and movement break protocols — daily rituals and exercise-adjacent interventions.

Protocol framework hub — personalisation engine, API integration guide, modality router (7 modalities × 12 EEG triggers), and matching guidance for 130+ mind-body practices. References 11 domain sub-skills (focus, stress, emotions, sleep, body, routines, nutrition, music, digital, breath-free, life-contexts) and the neuroskill-evidence skill. Always loaded when any protocol intent is detected; sub-skills are loaded contextually by domain.

Sleep, circadian, recovery, and rest protocols — interventions for drowsiness, wakefulness, bar at rest, sleep onset, ultradian rhythm, NSDR, yoga nidra, and power naps.

Stress, relaxation, autonomic regulation, HRV, hemispheric balance, and deep relaxation protocols — EEG-triggered interventions for bar, stress_index, relaxation, rmssd, lf_hf_ratio, faa asymmetry, and vagal tone.

NeuroSkill `status` command — full system snapshot including device state, signal quality, EEG scores, band powers, ratios, embeddings, labels (with top texts), app usage (top apps by time), screenshots (OCR counts + top apps), hooks summary, sleep summary, and recording history. Use when checking current EEG state, device connection, session metadata, what apps were used, or screenshot statistics.

NeuroSkill `sleep` and `umap` commands — EEG-based sleep stage classification (Wake/N1/N2/N3/REM) with efficiency and bout analysis, and 3D UMAP projection of session embeddings for spatial comparison. Use when analysing sleep quality or visualising neural state separation between sessions.

NeuroSkill Proactive Hooks — real-time EEG pattern matching with CRUD management, threshold suggestions, scenario gating (cognitive/emotional/physical), WebSocket broadcast triggers, and audit logging. Use when creating, managing, or debugging brain-state hooks and automation pipelines.

NeuroSkill `session` and `sessions` commands — per-session metric breakdowns with first/second-half trends, session listing across all days, and Unix timestamp helpers. Use when analysing a specific recording session or listing all available sessions.

NeuroSkill `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. Use when streaming live EEG events, speaking text aloud, sending alerts, starting calibration, or sending arbitrary commands.

NeuroSkill use-case recipes and scripting patterns — shell snippets for focus and productivity monitoring, stress tracking, sleep quality analysis, cognitive load queries, meditation tracking, cross-modal graph search, A/B session comparison, time-range queries, and automation with cron/Python/Node.js/HTTP. Use when looking for practical examples or building automation pipelines.

NeuroSkill EEG data reference — all metric fields including band powers, EEG ratios and indices, core scores, complexity measures, PPG/HRV fields, motion and artifact markers, sleep stage codes, headache/migraine correlate indices, and consciousness metrics. Use when looking up what a specific metric means or its value range.

NeuroSkill EEG API transport layer — WebSocket and HTTP protocols, port discovery, Quick Start, output modes (default/--json/--full), and global CLI flags. Use when setting up a connection, choosing transport, or understanding output format options.