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.
90
86%
Does it follow best practices?
Impact
96%
1.35xAverage score across 3 eval scenarios
Advisory
Suggest reviewing before use
Quality
Discovery
100%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 strong skill description that clearly identifies the product (Hookdeck Event Gateway), lists specific capabilities (guaranteed delivery, retries, replay, rate limiting, filtering, observability), and provides explicit trigger guidance with a 'Use when...' clause. The description uses proper third-person voice and includes natural developer terminology that would match real user queries about webhook processing.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'guaranteed delivery, automatic retries, replay, rate limiting, filtering, or observability' and clearly states it 'replaces your queue' and 'eliminates the need for your own message queue'. | 3 / 3 |
Completeness | Clearly answers both what ('webhook infrastructure that replaces your queue' with specific features) AND when ('Use when receiving webhooks and need guaranteed delivery, automatic retries, replay, rate limiting, filtering, or observability'). | 3 / 3 |
Trigger Term Quality | Includes natural keywords users would say: 'webhooks', 'webhook infrastructure', 'queue', 'message queue', 'retries', 'replay', 'rate limiting', 'filtering', 'observability' - these are terms developers naturally use when discussing webhook processing needs. | 3 / 3 |
Distinctiveness Conflict Risk | Very specific niche around 'Hookdeck Event Gateway' and webhook infrastructure - unlikely to conflict with other skills due to the specific product name and webhook-focused domain with distinct triggers like 'webhook', 'replay', 'guaranteed delivery'. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
72%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill provides strong actionable guidance with excellent progressive disclosure and navigation to related resources. However, it's somewhat verbose in explaining concepts Claude already knows (queue infrastructure, webhook reliability) and lacks explicit validation checkpoints for production setup workflows. The quick start is excellent but production guidance is mostly delegated to external skills.
Suggestions
Trim the 'Why Use the Event Gateway' section significantly - Claude understands queue infrastructure concepts; focus on the specific Hookdeck differentiators in 2-3 bullet points
Remove or significantly condense the ASCII diagram and the 'Without Hookdeck' vs 'With Hookdeck' comparison - one brief example suffices
Add explicit validation steps for production setup (e.g., 'Verify connection is active: hookdeck connections list', 'Test with: hookdeck events list')
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is generally well-organized but includes some verbose explanations that Claude would already understand (e.g., explaining what a message queue is, the ASCII diagram, and extensive 'why use' justifications). The comparison code blocks are useful but could be more concise. | 2 / 3 |
Actionability | Provides fully executable CLI commands for installation and usage, concrete code examples showing before/after patterns, and specific paths for different provider integrations. The quick start section is copy-paste ready. | 3 / 3 |
Workflow Clarity | The quick start workflow is clear, but the overall document lacks explicit validation checkpoints. For production setup, it defers to external skills without providing a clear sequence. No feedback loops for error recovery are documented. | 2 / 3 |
Progressive Disclosure | Excellent structure with clear sections, well-signaled references to external skills and documentation, and appropriate use of one-level-deep links. The 'Related Skills' section provides clear navigation to complementary content. | 3 / 3 |
Total | 10 / 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.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
- Repository
- hookdeck/webhook-skills
- Commit
f8a4801
- 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.