# wake-word-detection

Скилл для распознавания слова активации на openWakeWord: слушает микрофон локально, без облака. Пригодится, если собираете голосового ассистента вроде JARVIS.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 404 установки · ★ 48
- Автор: martinholovsky
- Лицензия: Unlicense · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/martinholovsky/claude-skills-generator/tree/HEAD/skills/wake-word-detection/SKILL.md
- Обновлён: 2025-12-06
- HTML: https://affpapa.org/nevibecode/skills/wake-word-detection

## Что делает

Скилл задаёт агенту роль эксперта по wake word detection: openWakeWord, keyword spotting, постоянно слушающие системы. Внутри — рабочий процесс через TDD. Сначала пишутся падающие тесты, потом минимальная реализация, потом полная проверка через `pytest` с покрытием.

Основной класс — `SecureWakeWordDetector`. Он держит буфер на `deque`, читает звук через `sounddevice`, гоняет предсказания модели и вызывает колбэк, когда уверенность выше порога. После срабатывания буфер очищается сразу. Зависимости перечислены явно: `openwakeword`, `numpy`, `sounddevice`, `onnxruntime`. Тесты проверяют порог срабатывания, очистку буфера, нагрузку на CPU и расход памяти.

Риск помечен как MEDIUM. Причина — постоянный доступ к микрофону. Скилл требует локальной обработки и советует не отправлять аудио наружу, но ответственность за это лежит на вашем коде. Если пишете ассистента, который слушает в фоне, проверьте, что колбэк не тянет за собой запись звука на диск.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add martinholovsky/claude-skills-generator --skill wake-word-detection -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/wake-word-detection/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/wake-word-detection/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add martinholovsky/claude-skills-generator --skill wake-word-detection -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/wake-word-detection/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add martinholovsky/claude-skills-generator --skill wake-word-detection -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/wake-word-detection/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install martinholovsky/claude-skills-generator wake-word-detection
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/wake-word-detection/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add martinholovsky/claude-skills-generator --skill wake-word-detection -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/martinholovsky/claude-skills-generator --path skills/wake-word-detection
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/wake-word-detection/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add martinholovsky/claude-skills-generator --skill wake-word-detection -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/martinholovsky/claude-skills-generator/tree/HEAD/skills/wake-word-detection/SKILL.md

## Когда брать
- распознать фразу активации «Hey JARVIS» без обращения к облаку
- держать постоянно слушающую систему в пределах 5% CPU
- уложить детектор в 100MB памяти
- написать тесты на порог срабатывания и очистку буфера
- снизить ложные срабатывания до уровня ниже одного в час

## Примеры запросов агенту
- напиши тесты для SecureWakeWordDetector по TDD, начни с порога срабатывания
- добавь проверку, что audio_buffer очищается сразу после детекции
- замерь CPU и память детектора за 10 секунд работы и сравни с целевыми значениями

## Похожие
- [speech](https://affpapa.org/nevibecode/skills/speech.md) — скилл · 3500 установок
- [mix-engineer](https://affpapa.org/nevibecode/skills/mix-engineer.md) — скилл · 339 установок
- [elevenlabs-tts](https://affpapa.org/nevibecode/skills/glebis-elevenlabs-tts.md) — скилл · 305 установок
- [tooluniverse-adverse-event-detection](https://affpapa.org/nevibecode/skills/tooluniverse-adverse-event-detection.md) — скилл · 369 установок
- [convert-word-to-md](https://affpapa.org/nevibecode/skills/convert-word-to-md.md) — скилл · 85 установок
- [voice-isolator](https://affpapa.org/nevibecode/skills/voice-isolator.md) — скилл · 6800 установок

Из того же набора: [martinholovsky/claude-skills-generator](https://affpapa.org/nevibecode/by/martinholovsky/claude-skills-generator.md) — 15 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md