CtrlK
BlogDocsLog inGet started
Tessl Logo

building-livekit-agents

Builds voice and chat AI agents with LiveKit Agents and LiveKit Cloud. Use when the user asks to "build a voice agent", "create a LiveKit agent", "add voice AI to my app", "implement handoffs", "structure an agent workflow", "my agent is slow / too chatty", "it says it booked but nothing was saved", "make it confirm before committing", "it keeps re-asking things the caller already said", or is writing code against the LiveKit Agents SDK. Covers architecture: designing for latency, keeping context small, splitting a monolithic agent into handoffs and tasks, and designing for voice. Also covers keeping the model in charge of meaning while code owns state, approvals, and effects. For API specifics use reading-livekit-docs. To check behavior use debugging-livekit-agents and testing-livekit-agents.

76

Quality

96%

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.

The body is a lean, opinionated architecture guide: dense with non-obvious rules, a clear pre-code-to-verification workflow with explicit checkpoints, and proper progressive disclosure to a real reference file and well-mapped sibling skills. Its only gap is the absence of any code, which it justifies by explicitly delegating API specifics to a companion skill.

DimensionReasoningScore

Conciseness

The body is almost entirely non-generic guidance — "Never classify intent with code", "omission preserves; missing, empty, unknown, and cleared are four different things", "If you can't say in one sentence what an agent is responsible for, split it" — with no explanation of concepts Claude already knows and no padding. Not a 4 because there is no section that reads as trimmable over-explanation; even the OSS/Cloud paragraph resolves a real ambiguity.

5 / 5

Actionability

Concrete directive guidance throughout: named env vars ("LIVEKIT_URL, LIVEKIT_API_KEY, LIVEKIT_API_SECRET"), a numbered pre-code checklist, and specific rules like "Validate *structure* in code (typed dates, enums, required fields); leave *meaning* to the model". Not a 5 because, as an instruction-only skill, it contains no executable code or commands — though it deliberately and explicitly delegates API specifics to reading-livekit-docs, which the rubric's scoring note partially excuses. Not a 3 because the guidance is concrete and executable in its decisions, not pseudocode-level hints.

4 / 5

Workflow Clarity

A clear sequence with explicit validation checkpoints: "Before you write code" (load docs, confirm credentials, decide structure, plan verification), then "Start with a failing complete-path test" with a guard-pairing feedback loop ("a test that rejects everything proves nothing about the guard"; "Keep that pair green while you add everything else"), and staged verification tiers (while building / before done / before shipping). Not a 4 because checkpoints are explicit at every stage rather than having minor gaps.

5 / 5

Progressive Disclosure

SKILL.md is a well-organized overview with one clearly signaled, one-level-deep reference — "The full treatment... is in `references/state-and-effects.md`. Read it before building anything that books, edits, confirms, or ends calls" — and the file exists in the bundle with substantive content (134 lines). A "Related skills" section maps each sibling skill to its role. Not a 4 because navigation is unambiguous and the split (overview here, deep treatment in the reference) is exactly appropriate.

5 / 5

Total

19

/

20

Passed

Description

100%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.

The description answers what and when with dense, concrete, third-person content: specific capabilities, verbatim user trigger phrases including failure complaints, and explicit routing to sibling skills to prevent overlap. Every clause earns its place despite the length.

DimensionReasoningScore

Specificity

"Builds voice and chat AI agents with LiveKit Agents and LiveKit Cloud", "implement handoffs", "splitting a monolithic agent into handoffs and tasks", "keeping the model in charge of meaning while code owns state, approvals, and effects" — multiple specific concrete actions covering the skill's full scope, matching the comprehensive-coverage anchor. Not a 4 because coverage is complete across architecture, state, and verification rather than having minor gaps.

5 / 5

Completeness

Explicitly answers what ("Builds voice and chat AI agents... Covers architecture: designing for latency, keeping context small...") and when ("Use when the user asks to...") with concrete quoted trigger phrases, exactly matching the anchor-5 example. Not a 4 because the 'when' clause is fully explicit with multiple concrete triggers, not merely present.

5 / 5

Trigger Term Quality

Natural user phrasings are quoted verbatim: "build a voice agent", "create a LiveKit agent", "add voice AI to my app", "my agent is slow / too chatty", "it says it booked but nothing was saved", "make it confirm before committing", "it keeps re-asking things the caller already said" — this covers symptom complaints users actually say, not just task requests. Not a 4 because synonym and failure-mode coverage is thorough, with no obvious missing natural terms.

5 / 5

Distinctiveness Conflict Risk

"LiveKit Agents and LiveKit Cloud" names a clear niche with distinct triggers, and routing to siblings is explicit ("For API specifics use reading-livekit-docs. To check behavior use debugging-livekit-agents and testing-livekit-agents"), which actively reduces conflict with related skills. Not a 4 because the domain name plus explicit delegation leaves minimal overlap risk.

5 / 5

Total

20

/

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
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.