resend-webhooks
Receive and verify Resend webhooks. Use when setting up Resend webhook handlers, debugging signature verification, handling email events like email.sent, email.delivered, email.bounced, or processing inbound emails.
93
93%
Does it follow best practices?
Impact
89%
1.09xAverage score across 3 eval scenarios
Passed
No known issues
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 an excellent skill description that follows best practices. It clearly states the capability (receiving and verifying Resend webhooks), provides an explicit 'Use when' clause with multiple specific trigger scenarios, and includes distinctive terminology (Resend-specific event names) that minimizes conflict risk with other skills.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'Receive and verify Resend webhooks', 'setting up webhook handlers', 'debugging signature verification', 'handling email events', and 'processing inbound emails'. Uses third person voice correctly. | 3 / 3 |
Completeness | Clearly answers both what ('Receive and verify Resend webhooks') and when ('Use when setting up Resend webhook handlers, debugging signature verification, handling email events...'). Has explicit 'Use when' clause with multiple trigger scenarios. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural terms users would say: 'Resend webhooks', 'webhook handlers', 'signature verification', specific event names like 'email.sent', 'email.delivered', 'email.bounced', and 'inbound emails'. These are terms developers would naturally use. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with 'Resend' as a specific service name, combined with specific event types (email.sent, email.delivered, email.bounced). Unlikely to conflict with generic webhook or email skills due to the Resend-specific terminology. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
87%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a high-quality skill that provides immediately actionable webhook handling code with excellent progressive disclosure. The code examples are complete and executable across multiple frameworks. The main weakness is the lack of explicit debugging workflows or validation checkpoints for troubleshooting signature verification failures, which is a common pain point.
Suggestions
Add a 'Debugging Signature Failures' section with a step-by-step troubleshooting workflow (e.g., 1. Check raw body middleware, 2. Verify header names, 3. Check secret format, 4. Validate timestamp)
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is lean and efficient, providing executable code without explaining basic concepts Claude already knows. Every section serves a purpose with no padding or unnecessary explanations about what webhooks are or how HTTP works. | 3 / 3 |
Actionability | Provides fully executable, copy-paste ready code examples in multiple languages (JavaScript/Express and Python/FastAPI). Includes both SDK-based and manual verification approaches with complete implementations. | 3 / 3 |
Workflow Clarity | While the code examples are clear, there's no explicit validation workflow or error recovery steps. The skill shows how to verify signatures but doesn't provide a checklist or feedback loop for debugging verification failures or handling edge cases. | 2 / 3 |
Progressive Disclosure | Excellent structure with clear overview, essential code upfront, and well-signaled one-level-deep references to examples/, references/, and external documentation. Content is appropriately split between quick-start code and detailed reference materials. | 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.
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.