clerk-webhooks

Receive and verify Clerk webhooks. Use when setting up Clerk webhook handlers, debugging signature verification, or handling user events like user.created, user.updated, session.created, or organization.created.

Quality

93%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

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

Highly actionable content with executable multi-language handlers and clean progressive disclosure to real reference files. The main weaknesses are duplicated verification logic inline and a padded list of sibling skills, plus a setup workflow that could be more explicitly sequenced.

Suggestions

Trim the inline Python manual-verification block and point to references/verification.md instead, since the same steps are documented there — this reduces token cost and duplication.

Replace or shorten the long 'Related Skills' list to only the most relevant companion (webhook-handler-patterns is already recommended above), removing the ~10-entry catalog that does not serve the core task.

Add a short numbered setup sequence (configure endpoint -> set env var -> verify signature -> handle event) with an explicit verify-and-retry note for debugging signature failures, to strengthen the workflow's feedback loop.

Dimension	Reasoning	Score
Conciseness	Largely lean and actionable with two complete code blocks and a compact event table, but the inline Python manual-verification block duplicates verification.md content, and the 'Related Skills' list of ~10 sibling skills adds padding not essential to the task.	4 / 5
Actionability	Provides copy-paste-ready Express and FastAPI handlers with real package names, header mapping, secret handling, and concrete event dispatch; env var and tunnel commands are directly executable.	5 / 5
Workflow Clarity	The handler code sequences verification before processing and includes validation checkpoints (missing headers, invalid payload, timestamp), but there is no end-to-end setup checklist or explicit verify->fix->retry feedback loop for debugging failures within the body.	4 / 5
Progressive Disclosure	Well-structured overview with clearly signaled one-level-deep references (references/overview.md, setup.md, verification.md, patterns.md) that exist as real files, and external examples linked out; content is appropriately split.	5 / 5
	Total	18 / 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.

A strong description: concise, concrete, with explicit 'Use when' trigger guidance and named Clerk event types. It clearly answers both what the skill does and when to invoke it, with minimal conflict risk.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — 'Receive and verify Clerk webhooks', 'setting up Clerk webhook handlers', 'debugging signature verification', 'handling user events' — with named event types, giving comprehensive coverage.	5 / 5
Completeness	Explicitly answers 'what' ('Receive and verify Clerk webhooks') and 'when' via a clear 'Use when' clause with concrete trigger phrases and example events.	5 / 5
Trigger Term Quality	Includes natural user phrases ('setting up Clerk webhook handlers', 'debugging signature verification', 'handling user events') plus concrete event-type keywords (user.created, session.created, organization.created) users would cite.	5 / 5
Distinctiveness Conflict Risk	A clearly named Clerk-specific niche with distinct svix/Clerk webhook triggers and event types; minimal overlap risk with other webhook skills since Clerk is named explicitly.	5 / 5
	Total	20 / 20 Passed

Validation

93%

Warnings & errors only

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

Criteria	Description	Result
relative_links	Relative link issues: 3 missing	Warning

	Total	15 / 16 Passed

Repository: hookdeck/webhook-skills
Path: skills/clerk-webhooks/SKILL.md
Commit: daaf3db

Reviewed: 3 days ago

Table of Contents

Discovery Implementation Validation

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.