CtrlK
BlogDocsLog inGet started
Tessl Logo

elevenlabs-webhooks

Receive and verify ElevenLabs webhooks. Use when setting up ElevenLabs webhook handlers, debugging signature verification, or handling call transcription events.

65

Quality

77%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Fix and improve this skill with Tessl

tessl review fix ./skills/elevenlabs-webhooks/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

64%

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

This is a solid, actionable skill with executable code examples across multiple languages and frameworks. Its main weaknesses are verbosity in the Related Skills and cross-references sections, an incomplete local development install command (empty code block), and lack of an explicit setup workflow sequence. The core webhook verification content is well-structured and immediately useful.

Suggestions

Fix the empty code block under 'Install via npm (recommended)' in the Local Development section — this is incomplete and breaks actionability for local testing.

Trim the Related Skills section to 3-4 most relevant skills or move the full list to a separate file; the current 10-item list with full GitHub URLs is excessive for the main SKILL.md.

Add an explicit numbered workflow for initial setup (e.g., 1. Configure webhook in ElevenLabs dashboard, 2. Copy signing secret, 3. Implement handler, 4. Test locally with Hookdeck CLI).

DimensionReasoningScore

Conciseness

The core content is reasonably efficient with executable examples, but the Related Skills section is excessively long (10 items with full URLs) and the skill provides three separate code examples (Express, Next.js, FastAPI) that are somewhat redundant. The 'Official ElevenLabs SDK Skills' section and the lengthy 'Recommended: webhook-handler-patterns' section with four sub-links add bulk.

2 / 3

Actionability

Provides fully executable, copy-paste ready code examples in JavaScript, TypeScript, and Python with proper imports, error handling, and environment variable usage. The local development section gives a concrete CLI command. The event types table is specific and useful.

3 / 3

Workflow Clarity

The code examples implicitly show the workflow (verify signature → handle event → return response), and the SDK note mentions 'On failure it throws; return 401.' However, there's no explicit numbered sequence for the overall setup workflow (create webhook in dashboard → get secret → implement handler → test locally), and the local development section has an incomplete install command (empty code block after '# Install via npm (recommended)').

2 / 3

Progressive Disclosure

The Resources section references well-organized files (references/overview.md, examples/express/, etc.) with clear one-level-deep navigation. However, no bundle files were provided to verify these exist, and the main SKILL.md includes substantial inline code that could arguably live in the referenced example directories. The Related Skills section is overly long for the main file.

2 / 3

Total

9

/

12

Passed

Description

89%

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

This is a well-crafted skill description that clearly identifies a narrow domain (ElevenLabs webhooks) with explicit trigger guidance. It covers both what the skill does and when to use it. The only minor weakness is that the 'what' portion could list more specific concrete actions beyond 'receive and verify'.

DimensionReasoningScore

Specificity

Names the domain (ElevenLabs webhooks) and some actions (receive, verify, setting up handlers, debugging signature verification, handling call transcription events), but doesn't list comprehensive concrete actions like parsing payload fields, configuring endpoints, or specific verification steps.

2 / 3

Completeness

Clearly answers both 'what' (receive and verify ElevenLabs webhooks) and 'when' with an explicit 'Use when' clause covering three distinct trigger scenarios: setting up handlers, debugging signature verification, and handling call transcription events.

3 / 3

Trigger Term Quality

Includes strong natural trigger terms: 'ElevenLabs', 'webhooks', 'webhook handlers', 'signature verification', 'call transcription events'. These are terms a user would naturally use when needing this specific functionality.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive — 'ElevenLabs webhooks' is a very specific niche that is unlikely to conflict with other skills. The mention of signature verification and call transcription events further narrows the scope.

3 / 3

Total

11

/

12

Passed

Validation

100%

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

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
hookdeck/webhook-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.