Operations Guide

Diagnose Vox latency issues via health checks, warm-up, benchmarks, and dashboard inspection.

5|Updated Mar 17, 2026
One-click install
npx skills add https://github.com/arach/vox --skill operations-guide-arach
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Operations Guide
Source: https://github.com/arach/vox/tree/main/docs
Command: npx skills add https://github.com/arach/vox --skill operations-guide-arach

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This guide helps you diagnose and resolve Vox latency or reliability issues by turning vague “it feels slow” reports into actionable checks of warm-up, inference, and end-to-end runtime metrics.

Core Features & Use Cases

  • Clarifies the best operator workflow for verifying health, warming models, benchmarking audio, and inspecting the local performance dashboard.
  • Recommends how to interpret telemetry so you can separate cold-path costs from hot-path inference costs (using inferenceMs, totalMs, and modelLoadMs).
  • Provides practical contributor guidance to keep clientId, route, and modelId stable so performance comparisons remain meaningful over time.

Quick Start

Run the Vox operations loop by executing the doctor check first, then starting warm-up, benchmarking a real audio file, and finally opening the performance dashboard filtered to your integration’s clientId.

Frequently Asked Questions about Operations Guide

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

FAQPage Schema
How do I triage Vox latency issues and separate cold-path costs from hot-path inference?

To triage Vox latency, run health checks and explicit warm-ups to separate cold-path modelLoadMs costs from hot-path inferenceMs and totalMs metrics. This isolates whether slow audio transcription or synthesis stems from initial model loading or active processing.

What is the best workflow for diagnosing cold versus warm Vox performance behavior?

The best workflow for diagnosing cold versus warm Vox behavior starts with a doctor check, followed by model warm-up, benchmarking a real audio file, and inspecting the performance dashboard. This ordered runtime verification isolates latency shifts across transcription and synthesis workflows.

How do I interpret Vox telemetry metrics like inferenceMs and totalMs during performance triage?

Interpret Vox telemetry by analyzing inferenceMs for active processing speed, totalMs for end-to-end runtime, and modelLoadMs for initial loading context. This metric interpretation clarifies whether latency spikes occur during model loading or actual audio inference.

Why are my Vox performance benchmarks inconsistent across different client integrations?

Vox performance benchmarks become inconsistent if clientId, route, and modelId are not kept stable across tests. Contributor-safe guidance requires preserving these telemetry dimensions so performance comparisons remain meaningful over time across multiple client integrations.

When should I run explicit model warm-up before benchmarking audio processing?

Run explicit model warm-up before benchmarking audio processing whenever you need to measure hot-path inference latency without cold-start overhead. Warming models ensures repeatable benchmarks that reflect actual transcription and synthesis runtime rather than initial modelLoadMs delays.

Does Vox performance triage work for both transcription and synthesis latency reports?

Yes, Vox performance triage applies to diagnosing cold-vs-warm behavior across both transcription and synthesis workflows. Using consistent telemetry dimensions and ordered runtime verification steps ensures accurate latency diagnosis across multiple client integrations.