CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

debugging-livekit-agents

Drives a live multi-turn conversation with a LiveKit agent running locally, using `lk agent debugger`. Use when the user says "test my agent", "try my agent", "does this work", or "why did it call that tool", after editing an agent to check how it behaves, or when an agent on a speech-to-speech model or one that mishears users needs checking. The default for a bare "test"; for regression tests use testing-livekit-agents, for graded runs running-livekit-simulations.

Quality

92%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

92%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

An exemplary instruction-only skill body: a clearly sequenced debug loop with genuine feedback loops (reproduce → fix → re-run, restart after edit, check history), lean prose that delegates flag detail to the CLI's help, and disciplined scope control including a routing table for when to use sibling skills instead. The single minor gap is that a few inspection subcommands and the log-interleaving flag are referenced only via --help rather than named inline, which slightly reduces copy-paste readiness.

DimensionReasoningScore

Conciseness

Lean and efficient throughout: it assumes competence, never explains what LiveKit or agents are, and explicitly declines to restate CLI flags ('The help is thorough and is the source of truth for subcommands and flags, so this skill doesn't restate them'). Matches anchor 5 — every token earns its place; not 4 because there is no trimmable over-explanation.

5 / 5

Actionability

The start/say/stop command block and the pre-flight '--help' check are concrete and executable, and the debugging strategies are specific ('Read the tool calls as well as the reply', 'Interleave the logs'). However, the inspection subcommands (chat history, event stream, logs, status) are named only by deferral to '--help lists the subcommands' and the log-interleaving feature is 'an option' without its flag — minor gaps that keep it at anchor 4 rather than 5, and clearly above 3 since everything given is executable, not pseudocode.

4 / 5

Workflow Clarity

The loop is clearly sequenced ('Start the agent, say user turns, inspect what happened, edit the code, restart, repeat, and stop') with explicit checkpoints and feedback loops: pre-flight command verification, 'Restart after every code edit', 'Reproduce before you fix, then re-run the same turns', and 'Check the chat history before concluding the agent never answered'. Matches anchor 5 (explicit validation and error-recovery loops); not 4 because checkpoints are explicit rather than merely present. No destructive/batch operations, so no cap applies.

5 / 5

Progressive Disclosure

No bundle files exist, and none are needed: the body is a well-sectioned overview that appropriately pushes all command/flag detail to the CLI's own '--help' rather than inlining it, with clear headers, one well-signaled internal anchor ('[Audio mode](#audio-mode)'), a routing table, and a related-skills section. Matches anchor 5 (clear overview, appropriately split, easy navigation); not 4 because no content is misplaced or buried.

5 / 5

Total

19

/

20

Passed

Description

90%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: concrete third-person statement of what it does, an explicit 'Use when' clause packed with natural quoted trigger phrases, and explicit disambiguation from sibling skills. The only relative weakness is specificity — it names one core capability (driving a live conversation via lk agent debugger) rather than enumerating several, though for a single-purpose CLI skill this is arguably appropriate scope.

DimensionReasoningScore

Specificity

Names the domain and one concrete action — 'Drives a live multi-turn conversation with a LiveKit agent running locally, using lk agent debugger' — but lists only that single action rather than several specific capabilities. It matches anchor 3 (1-2 concrete actions, not comprehensive); it is not 4 because no multi-action list is present, and not 2 because the action and tool are fully concrete, not generic.

3 / 5

Completeness

Explicitly answers both what ('Drives a live multi-turn conversation with a LiveKit agent running locally, using lk agent debugger') and when (an explicit 'Use when' clause with concrete quoted trigger phrases). This matches anchor 5 exactly; not 4 because the 'when' is fully explicit with concrete triggers.

5 / 5

Trigger Term Quality

Comprehensive natural phrasings users would actually say: 'test my agent', 'try my agent', 'does this work', 'why did it call that tool', plus situations like 'after editing an agent' and 'mishears users'. Matches anchor 5 (comprehensive coverage including synonyms); nothing common is missing, so it is not 4.

5 / 5

Distinctiveness Conflict Risk

Clear niche (live interactive debugging of LiveKit agents) with explicit routing to sibling skills: 'for regression tests use testing-livekit-agents, for graded runs running-livekit-simulations'. Minimal conflict risk — matches anchor 5, not 4, because overlap is actively disambiguated rather than merely narrow.

5 / 5

Total

18

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository

livekit/agent-skills

Path

skills/debugging-livekit-agents/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.