CtrlK
BlogDocsLog inGet started
Tessl Logo

hookdeck-event-gateway

Hookdeck Event Gateway — webhook infrastructure that replaces your queue. Use when receiving webhooks and need guaranteed delivery, automatic retries, replay, rate limiting, filtering, or observability. Eliminates the need for your own message queue for webhook processing.

64

Quality

80%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./skills/hookdeck-event-gateway/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

61%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 delivers an actionable quick start and dense, accurate product specifics with good external reference structure, but it is padded with marketing-style framing that duplicates the description and lacks any validation or test-webhook checkpoint in its workflows. All deep content is delegated to external resources rather than a local bundle.

Suggestions

Trim the 'Why Use the Event Gateway' bullet list and 'Hookdeck Is Your Queue' prose — they restate the frontmatter description; keep one concise value statement and the with/without code contrast at most.

Add a validation step to the quick start, e.g., send a test request to the tunnel URL and confirm it appears in the dashboard before wiring it into a provider.

Bundle key material (e.g., signature verification code) in a local references/ file instead of requiring a separate skill install or external GitHub browse for details Claude needs inline.

DimensionReasoningScore

Conciseness

Mostly efficient — product-specific facts (50 retry attempts, 'Retry-After' header, 'x-hookdeck-signature', the 60-second window) earn their place — but sections like 'Why Use the Event Gateway' and 'Hookdeck Is Your Queue' restate the frontmatter description as prose, and the with/without JavaScript comparison plus ASCII diagram pad the body. It fits 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than the minor-trim level, because whole sections could be cut or compressed.

3 / 5

Actionability

Concrete, copy-paste-ready commands are given ('npx hookdeck-cli listen 3000 gateway --path /webhooks', 'npx skills add hookdeck/webhook-skills --skill hookdeck-event-gateway-webhooks') alongside executable handler examples and specific configuration details (max delivery rates, retry status codes). It stops short of a 5 because the handler code is illustrative comparison snippets rather than a complete worked example, and core detail (signature verification code) is deferred to an external skill.

4 / 5

Workflow Clarity

The quick start is a clear sequence (run listen command, receive public URL, optionally point the tunnel at an existing handler), but there are no validation checkpoints — nothing tells the user to confirm the tunnel is forwarding or send a test webhook before relying on it. The rest of the body is a feature catalog rather than a sequenced process, fitting 'steps listed but validation gaps' rather than the level above, which requires most checkpoints present.

3 / 5

Progressive Disclosure

The body is a well-organized overview with clearly signaled, one-level-deep references to Hookdeck docs pages (filters, transformations, deduplication, retries, metrics) and to sibling skills via 'npx skills add' commands and GitHub links. It falls short of the top anchor because no reference files are bundled locally — all detail lives behind external URLs or a separate skill install — and some feature detail that could be split out is inlined.

4 / 5

Total

14

/

20

Passed

Description

88%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 with an explicit 'Use when...' trigger clause, a clear statement of what the skill provides, and a comprehensive list of concrete capabilities. Its only weaknesses are minor: a few natural trigger synonyms are absent and it shares webhook terminology with sibling provider skills.

DimensionReasoningScore

Specificity

The description names the domain ('webhook infrastructure that replaces your queue') and lists multiple concrete capabilities: 'guaranteed delivery, automatic retries, replay, rate limiting, filtering, or observability'. This is comprehensive coverage of the gateway's feature set, matching the anchor for multiple specific concrete actions rather than the 'minor gaps' level below.

5 / 5

Completeness

It explicitly answers what ('webhook infrastructure that replaces your queue... guaranteed delivery, automatic retries, replay, rate limiting, filtering, or observability') and when ('Use when receiving webhooks and need guaranteed delivery, automatic retries, replay...'). Both are concrete and explicit with trigger phrases, matching the top anchor; it is not the level below because the 'when' clause is specific, not merely present.

5 / 5

Trigger Term Quality

Natural phrases a user would say are present: 'receiving webhooks', 'guaranteed delivery', 'retries', 'replay', 'rate limiting', 'queue'. A few natural synonyms or concrete trigger scenarios (e.g., 'webhook handler', 'lost webhooks', 'dead-letter') are missing, so it fits 'good keyword coverage; a few natural terms missing' rather than the fully comprehensive anchor.

4 / 5

Distinctiveness Conflict Risk

The 'replaces your queue' framing and queue/delivery terminology carve a clear niche distinct from general skills, but the description overlaps with provider-specific webhook skills (stripe-webhooks, shopify-webhooks) that share the 'webhooks' trigger terms. This fits 'mostly distinct; minor overlap risk with closely related skills' rather than the minimal-conflict anchor.

4 / 5

Total

18

/

20

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.

Validation — 16 / 16 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.