CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

event-gateway

Comprehensive guide to the Hookdeck Event Gateway for receiving, routing, and delivering webhooks and events. Covers setup, connections, authentication, local development, monitoring, and API automation. Use when receiving webhooks, setting up webhook endpoints, testing webhooks locally, configuring webhook relay or event queue, event routing, webhook retry, webhook monitoring, third-party routing, asynchronous APIs, or local webhook development. For provider webhooks (Stripe, Shopify, Chargebee, GitHub, etc.), use together with the matching skill from hookdeck/webhook-skills; do not only parse JSON — use provider SDK verification and event construction (e.g. Stripe constructEvent).

Quality

89%

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

SKILL.md
Quality
Evals
Security

Quality

Content

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

A well-engineered skill body: concrete executable commands, a clearly sequenced workflow with checklist and confirmation loops, and an organized one-level reference structure. Its weaknesses are duplication (CLI-prerequisite and provider-composition guidance repeated multiple times), long inlined decision prose, and references to example codebases that are absent from the bundle.

Suggestions

State the Hookdeck CLI install prerequisite once in a canonical section linking cli-workflows.md#hookdeck-cli-prerequisite, and reference it from Quick Start and the Workflow Stages note instead of repeating the full guidance in four places.

Fix the references to examples/express/, examples/nextjs/, and examples/fastapi/ — either include those example codebases in the bundle or remove the claims that they are 'runnable, proven, and tested' and point at references/verification-code.md alone.

Move the multi-paragraph 'How agents choose: CLI, API, or Dashboard' guidance into a reference file (e.g., cli-workflows.md or a new interface-selection.md), keeping a two- or three-line default rule in the SKILL.md body.

DimensionReasoningScore

Conciseness

The body avoids explaining concepts Claude already knows and is mostly dense, useful guidance, but it is noticeably padded by repetition: the CLI-install prerequisite is stated in four places ('Hookdeck CLI prerequisite', the Workflow Stages note, Quick Start, and the Reference table), the provider-composition guidance in three, and the whoami/context flow twice; the ~250-word Production paragraph and ~60 lines of CLI-vs-API-vs-Dashboard decision prose could be tightened or moved to references. Matches anchor 3 ('mostly efficient but could be tightened') better than anchor 4, which allows only minor trimming.

3 / 5

Actionability

Copy-paste-ready commands cover the common cases: 'hookdeck ci' / 'hookdeck whoami' for non-interactive auth, 'hookdeck listen 3000 <source_name> --path /webhooks' for the quick path, 'npx skills add hookdeck/webhook-skills --skill {provider}-webhooks -y -g', and 'hookdeck project use <org-name> <project-name>' for context switching, plus explicit flags and URLs. Fully matches the anchor-5 example (executable commands covering common cases).

5 / 5

Workflow Clarity

The Workflow Stages give an explicit ordered 4-stage sequence (01-setup through 04-iterate), a pre-scaffold checklist (provider-webhooks-checklist.md), and a real feedback loop: run 'hookdeck whoami', show output, confirm with the user, and if wrong list/switch/re-run/confirm again. This matches anchor 5 (clear sequence, explicit validation, feedback loops, checklists); anchor 4 would require missing checkpoints, and none of the operations here are destructive/batch to trigger the cap.

5 / 5

Progressive Disclosure

Good structure: 14 one-level-deep reference files organized in 'Area / Resource / When to use' tables with verified anchors (e.g., cli-workflows.md#project-management, monitoring-debugging.md#cli-metrics all resolve). Held at 4 rather than 5 because the body twice points to 'examples/express/', 'examples/nextjs/', and 'examples/fastapi/' as 'runnable, proven, and tested' codebases, but no examples/ directory exists in this bundle — broken references the agent cannot follow — and the inlined CLI/API/Dashboard decision prose is content that belongs in a reference file.

4 / 5

Total

17

/

20

Passed

Description

96%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 capabilities, an explicit and comprehensive 'Use when' trigger clause in third person, and clear composition guidance for provider webhook skills. The only residual risk is overlap with the provider webhook skills it deliberately layers with.

DimensionReasoningScore

Specificity

Lists multiple concrete actions with comprehensive coverage: 'receiving, routing, and delivering webhooks and events' plus 'setup, connections, authentication, local development, monitoring, and API automation'. Matches the anchor-5 example (multiple specific concrete actions, comprehensive) rather than anchor 4, which implies minor coverage gaps; none are evident for this domain.

5 / 5

Completeness

Explicitly answers both what ('Comprehensive guide to the Hookdeck Event Gateway for receiving, routing, and delivering webhooks... Covers setup, connections, authentication, local development, monitoring, and API automation') and when (a full 'Use when...' clause with concrete triggers), exactly matching the anchor-5 example structure. The explicit 'Use when' clause also satisfies the completeness cap rule.

5 / 5

Trigger Term Quality

'Use when receiving webhooks, setting up webhook endpoints, testing webhooks locally, configuring webhook relay or event queue, event routing, webhook retry, webhook monitoring, third-party routing, asynchronous APIs, or local webhook development' covers natural phrasings and synonyms comprehensively, matching the anchor-5 pattern (e.g., both 'testing webhooks locally' and 'local webhook development').

5 / 5

Distinctiveness Conflict Risk

The Hookdeck Event Gateway niche is distinct and the description explicitly routes provider cases ('use together with the matching skill from hookdeck/webhook-skills; do not only parse JSON'), which mitigates overlap. It stays at 4 rather than 5 because generic triggers like 'receiving webhooks' will still fire for pure provider-verification tasks (e.g., 'receive Stripe webhooks') where this skill is only a companion; above anchor 3 because the composition guidance actively disambiguates.

4 / 5

Total

19

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 6 missing

Warning

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

14

/

16

Passed

Repository

hookdeck/agent-skills

Path

skills/event-gateway/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.