Agent skill · data analytics · livekit
livekit-simulations
Generate targeted test scenarios for a LiveKit voice or chat agent and run them as simulations — locally, from the agent''s own code plus what the user wants stress-tested. Use whenever the user wants to "test my agent", "what should I test", "create/generate simulation scenarios", "make a sim test suite", "use lk agent simulate", "stress-test the X flow", "set up scenarios for my agent", or wants to probe edge cases / refusals / regressions before shipping. Generates scenarios on the user''s machine (their code is never uploaded) and lets the user deeply steer what gets tested. Trigger even without the word "simulation" when the user clearly wants to decide what to test and verify how their agent behaves across realistic conversations. Not for building a new agent from scratch (use the livekit-agents skill), load-testing, or ordinary unit tests.
Why this skill is useful
Generates targeted test scenarios based on the agent's actual code and user-defined stress tests, which the AI wouldn't reliably create on its own.
What it needs
Requires livekit-agents installed locally. About 4k tokens when loaded. Last updated 2026-06-16. 62 stars on the source repository.
What this skill does
<!-- ============================================================ BETA NOTICE — TEMPORARY. Delete this whole block (down to the END BETA NOTICE marker) at GA. Everything from the "# Generating Simulation Scenarios" heading onward is the permanent, production-oriented skill. ============================================================ --> ⚠️ Simulations are in private beta (not yet generally available). - No docs/MCP coverage yet. For the lk agent simulate command surface, use lk agent simulate --help and the LiveKit Cloud dashboard rather than lk docs / MCP until simulations are documented. - Recent SDK required. Running simulations needs the 1.6 line of livekit-agents. Confirm the installed version rather than assuming. - Limited availability / auth. Creating runs needs the project enabled for simulations and a current lk cloud auth session. (Generating scenarios — the main job of this skill — needs neither; it's fully local.) <!-- ===================== END BETA NOTICE ====================== --> Generating Simulation Scenarios The most valuable thing you can do with simulations is generate good test scenarios for the user's agent — grounded in the agent's actual code and in what the user wants stress-tested — then run them. You do this locally: you read the code with your normal tools (nothing is uploaded), and you (the coding agent) are the model that does the generation, so no extra API keys or services are needed. A scenario = a simulated user's persona + goals (instructions) and the pass criteria (agentexpectations). A simulation plays each scenario against the agent over text and an LLM judge scores it. Your job is to produce a high-quality, diverse, on-target set of scenarios and write them to a YAML scenarios file the CLI can run. What makes this better than autopilot A naive "just generate some tests" misses the point. Three things make this skill worth using: 1. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills livekit/livekit-simulations