What problem does it solve? The Nexi desktop HUD can lag, freeze, or ignore state updates, and the root cause is often misattributed to slow Python when it is actually DOM thrashing in JavaScript, a missing JS function on the Eel bridge, or an intentional voice-state transition rejection. This Skill provides the diagnostic knowledge to locate the real cause quickly. ## Core Features & Use Cases - Rendering Performance Guidance: Explains the fixed DOM-thrash bug in hud_orb.js (rebuilding waveform bars via innerHTML every frame) and the rule to mutate existing nodes inside the requestAnimationFrame loop instead of reconstructing them. - Eel Bridge Debugging: Documents _safe_eel_call and the [EEL] missing_js_function log line that identifies exactly which JS-side function is absent when the HUD stops updating. - Voice-State Machine Gotchas: Clarifies that transition_failed reason=no_valid_transition is usually correct cooldown behavior, and how to read conflict_resolved logs when two sources race to set UI state. - Use Case: When the orb waveform stutters or the transcript stops appearing, follow the Skill's checklist: check the missing-function log first, verify cooldown timers before editing the transition table, and confirm fixes by driving the real HUD via Playwright or chrome-devtools MCP. ## Quick Start Debug why the Nexi HUD waveform is lagging and the transcript stopped updating, checking the Eel bridge logs and voice-state transitions.
