voice-system-expert

Enforce Quetrex voice architecture decisions for WebRTC and OpenAI Realtime API changes.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/Barnhardt-Enterprises-Inc/quetrex-plugin --skill voice-system-expert
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: voice-system-expert
Source: https://github.com/Barnhardt-Enterprises-Inc/quetrex-plugin/tree/main/templates/skills/voice-system-expert
Command: npx skills add https://github.com/Barnhardt-Enterprises-Inc/quetrex-plugin --skill voice-system-expert

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Modifying complex voice systems without deep understanding can easily introduce critical bugs like echo, feedback loops, or broken real-time communication, leading to a frustrating user experience. This Skill provides expert guidance on Quetrex's battle-tested voice architecture, preventing costly mistakes and ensuring a seamless voice interface.

Core Features & Use Cases

  • Critical Architecture Enforcement: Mandates "Always-On Microphone + Browser AEC" as the core design, explaining its benefits and why it's the industry standard.
  • Anti-Pattern Identification: Clearly outlines what not to do (e.g., toggling microphone tracks, routing audio outside the browser, custom echo cancellation), saving you from common pitfalls.
  • Implementation Guidance: Directs to primary files and functions for safe modifications, and explains the rationale behind architectural decisions, empowering you to make informed changes.
  • Use Case: Before attempting any changes to Quetrex's voice interface, activate this Skill. It will provide a critical overview of the core architecture, a list of "DO NOT DO THESE THINGS," and the specific files to work with, ensuring you don't inadvertently break the existing system.

Quick Start

I need to adjust the audio quality settings for the Quetrex voice system. What are the allowed parameters I can modify?

Frequently Asked Questions about voice-system-expert

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I prevent echo and feedback loops in a WebRTC voice system?

Echo cancellation in WebRTC voice systems is best handled browser-side using the Always-On Microphone + Browser AEC pattern. This architecture captures audio continuously and applies acoustic echo cancellation within the browser before sending to the server, eliminating feedback loops and ensuring clean real-time communication without custom implementations.

What are the critical architectural constraints for the OpenAI Realtime API voice interface?

The core voice architecture mandates always-on microphone behavior with browser-based echo cancellation and server-side VAD integration. Do not toggle microphone tracks, route audio outside the browser, or implement custom echo cancellation—these introduce regressions. Use documented primary files and follow architectural decisions to maintain fidelity and prevent critical bugs.

Can I modify audio quality settings in the Quetrex voice system safely?

Audio quality adjustments must respect the Always-On Microphone + Browser AEC constraint and server-side VAD integration. Only modify parameters within primary files designed for this purpose. Document why changes align with architectural requirements and test against functional specifications for always-on behavior and fidelity before deploying safety-critical updates.

What mistakes should I avoid when updating a real-time voice interface?

Avoid toggling microphone tracks, routing audio outside the browser, and implementing custom echo cancellation—these break real-time communication and introduce critical bugs. Instead, enforce the Always-On Microphone + Browser AEC pattern, use server-side VAD, and work within designated primary files to ensure safety-critical behavior and seamless user experience.

Why is browser-based echo cancellation preferred over server-side approaches?

Browser-based acoustic echo cancellation (AEC) is the industry standard for real-time voice systems because it eliminates echo before transmission, reducing latency and ensuring clean audio at source. Combined with server-side VAD, this architecture provides both immediate feedback prevention and intelligent voice activity detection for efficient processing.

How do I debug voice system regressions in code reviews or updates?

Voice system regressions stem from violating core architecture: always-on microphone, browser AEC, and server-side VAD. During reviews, check that changes respect these constraints, use only designated primary files, and do not introduce anti-patterns like microphone toggling or custom echo cancellation. Enforce architectural decisions before deploying to catch safety-critical bugs early.