optional-skills/health/neuroskill-bci/references/protocols.md
Over 70 mind-body practices triggered by specific biometric (EXG) signals. These are sourced from NeuroLoop's protocol repertoire and are designed to be suggested when the system detects specific cognitive or physiological states.
⚠️ Contraindication: Wim Hof and hyperventilation-style breathwork are unsuitable for epilepsy_risk > 30, known cardiac conditions, or pregnancy.
Always ask before starting. Match ONE protocol to the single most salient metric signal. Explain the metric connection to the user.
| User State | Recommended Protocol |
|---|---|
| Focus < 0.40, TBR > 1.5 | Theta-Beta Neurofeedback Anchor or Box Breathing |
| Low engagement, session start | WOOP or Pre-Task Priming |
| Relaxation < 0.30, stress_index high | Cardiac Coherence or 4-7-8 Breathing |
| Cognitive Load > 0.70 sustained | Cognitive Load Offload (Mind Dump) |
| Engagement < 0.30 for > 20 min | Novel Stimulation Burst or Environment Change |
| Flow State (focus > 0.75, engagement > 0.70) | Do NOT interrupt — protect the session |
| Drowsiness > 0.60, post-lunch | Ultradian Reset or Power Nap |
| FAA < 0, depression_index elevated | FAA Rebalancing |
| Low RMSSD (< 25ms) | Vagal Toning |
| High stillness + headache signals | Neck Release Sequence |
| Pre-sleep, HRV low | Sleep Wind-Down |
| Post-social-media, low mood | Envy & Comparison Alchemy |
Duration: ~90 seconds Trigger: High TBR (> 1.5) and low focus Instructions:
Duration: 90 seconds Trigger: Scattered engagement, difficulty settling into task Instructions:
Duration: 3 minutes Trigger: Low PAC θ-γ (theta-gamma coupling), low sample entropy Instructions:
Duration: 5 minutes Trigger: High beta, low rel_alpha — system is too analytically locked Instructions:
Duration: 3 minutes Trigger: Low PAC θ-γ, low sample entropy Instructions:
Duration: 2–3 minutes Trigger: Low APF (< 9 Hz), dementia_index > 30 Instructions:
Duration: 2–4 minutes Trigger: High BAR, high anxiety_index, acute stress Instructions:
Duration: 3–5 minutes Trigger: Acute stress spikes, racing thoughts, high sympathetic activation Instructions:
Duration: 5 minutes Trigger: Low RMSSD (< 30 ms), high stress_index Instructions:
Duration: 30 seconds (1–3 cycles) Trigger: Rapid overwhelm, acute panic Instructions:
Duration: 5 minutes Trigger: High beta, low relaxation — cannot relax Instructions:
Duration: 5–10 minutes Trigger: Low LZC (< 40 on 0-100 scale) — neural complexity too low Instructions:
Duration: 3 minutes Trigger: Low RMSSD (< 25 ms) — weak vagal tone Instructions:
Duration: 5 minutes Trigger: Negative FAA (right-hemisphere dominant), high depression_index Instructions:
Duration: 5–10 minutes Trigger: Loneliness signals, shame, low mood Instructions:
Duration: 2 minutes Trigger: High bipolar_index or extreme FAA swings Instructions:
Duration: 3–5 minutes Trigger: Acute distress, trauma activation, overwhelming anxiety Instructions:
Duration: ~8 minutes Trigger: Rising anxiety without clear cause Instructions:
Duration: 2 minutes Trigger: Anger signals, high BAR + elevated HR Instructions:
Duration: 3 minutes Trigger: Post-social-media, envy signals Instructions:
Duration: 3–5 minutes Trigger: Existential flatness, low engagement, loss of meaning Instructions:
Duration: 20 minutes Trigger: End of a 90-minute focus block, drowsiness rising Instructions:
Duration: 5 minutes Trigger: narcolepsy_index > 40, severe drowsiness Instructions:
Duration: 20–30 minutes Trigger: Accumulated fatigue, need deep recovery without sleeping Instructions:
Duration: 10–20 minutes (set alarm!) Trigger: Drowsiness > 0.70, post-lunch slump, Theta dominant Instructions:
Duration: 60 minutes before bed Trigger: Evening session, rising drowsiness, pre-sleep Instructions:
Duration: 10 minutes Trigger: Relaxation < 0.25, HRV declining over session Instructions:
Duration: 3 minutes Trigger: Panic, dissociation, acute anxiety spike Instructions:
Duration: 20 seconds Trigger: Extended screen time, eye strain Instructions:
Duration: 3 minutes Trigger: High stillness (> 0.85) + headache_index elevated Instructions:
Duration: 2 minutes Trigger: Very high stillness, prolonged static sitting Instructions:
Duration: 5 minutes Trigger: Cognitive load > 0.70 sustained, racing thoughts, high beta Instructions:
Duration: 90 seconds Trigger: Phone addiction signals, urge to check social media Instructions:
Duration: Ongoing Trigger: Flatness from short-form content spikes Instructions:
Duration: 60–90 minutes before bed Trigger: Evening, pre-sleep routine Instructions:
Trigger: Morning routine, anxiety_index Guidelines:
Trigger: Post-lunch drowsiness spike Instructions:
Duration: 5 minutes Trigger: Low engagement before a task Instructions:
Duration: 3 minutes Trigger: Low engagement at session start, drowsiness < 0.50 Instructions:
When guiding the user through a protocol:
npx neuroskill status --json to see if metrics improvednpx neuroskill label "post-protocol: [name]" for tracking