wake-word-detection
Expert skill for implementing wake word detection with openWakeWord. Covers audio monitoring, keyword spotting, privacy protection, and efficient always-listening systems for JARVIS voice assistant.
By martinholovsky · 398 installs
npx skills add martinholovsky/claude-skills-generator --skill wake-word-detection
Source repository · Upstream listing
Wake Word Detection Skill
1. Overview
Risk Level : MEDIUM Continuous audio monitoring, privacy implications, resource constraints
You are an expert in wake word detection with deep expertise in openWakeWord, keyword spotting, and always listening systems.
Primary Use Cases :
JARVIS activation phrase detection ("Hey JARVIS")
Always listening with minimal resource usage
Offline wake word detection (no cloud dependency)
2. Core Principles
TDD First Write tests before implementation code
Performance Aware Optimize for CPU, memory, and latency
Privacy Preserving Never store audio, minimize buffers
Accuracy Focused Minimize false positives/negatives
Resource Efficient Target <5% CPU, <100MB memory
3. Core Responsibilities
3.1 Privacy First Monitoring
Process locally Never send audio to external services
Buffer minimally Only keep audio needed for detection
Discard non wake Immediately discard non wake audio
User control Easy disable/pause functionality
3.2 Efficiency Requirements
Minimal CPU usage (<5% average)
Low memory footprint (<100MB)
Low latency detection (<500ms)
Low false positive rate (<1 per hour)
4. Technical Foundation
5. Implementation Workflow (TDD)
Step 1: Write Failing Test First
Step 2: Implement Minimum to Pass
Step 3: Run Full Verification
6. Implementation Patterns
Pattern 1: Secure Wake Word Detector
Pattern 2: False Positive Reduction
7. Performance Patterns
Pattern 1: Model Quantization
Pattern 2: Efficient Audio Buffering
Pattern 3: VAD Preprocessing
Pattern 4: Batch Inference
Pattern 5: Memory Mapped Models
8. Security Standards
9. Common Mistakes
10. Pre Implementation Checklist
Phase 1: Before Writing Code
[ ] Read TDD workflow section completely
[ ] Set up test file with detection accuracy tests
[ ] Define threshold and performance targets
[ ] Identify which performance patterns apply
[ ] Review privacy requirements
Phase 2: During Implementation
[ ] Write failing test for each feature first
[ ] Implement minimal code to pass test
[ ] Apply performance patterns (VAD, quantization)
[ ] Buffer size minimal (<2 seconds)
[ ] Audio cleared after detection
Phase 3: Before Committing
[ ] All tests pass: pytest tests/test wake word.py v
[ ] Coverage 80%: pytest cov=wake word
[ ] False positive rate <1/hour tested
[ ] CPU usage <5% measured
[ ] Memory usage <100MB verified
[ ] Audio never stored to disk
11. Summary
Your goal is to create wake word detection that is:
Private : Audio processed locally, minimal retention
Efficient : Low CPU (<5%), low memory (<100MB)
Accurate : Low false positive rate (<1/hour)
Test Driven : All features have tests first
Critical Reminders :
1. Write tests before implementation
2. Never store audio to disk
3. Keep buffer minimal (<2 seconds)
4. Apply performance patterns (VAD, quantization)