sendgrid-webhooks
Receive and verify SendGrid webhooks. Use when setting up SendGrid webhook handlers, debugging signature verification, or handling email delivery events.
91
88%
Does it follow best practices?
Impact
95%
1.11xAverage score across 3 eval scenarios
Advisory
Suggest reviewing before use
Quality
Discovery
89%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 solid skill description with excellent trigger terms and completeness. It clearly identifies when to use the skill and targets a specific niche (SendGrid webhooks). The main weakness is that the capability description could be more specific about the concrete actions performed beyond 'receive and verify'.
Suggestions
Expand the capabilities list with more specific actions like 'parse event payloads', 'validate HMAC signatures', 'handle bounce/delivery/open events'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (SendGrid webhooks) and some actions ('receive', 'verify'), but lacks comprehensive concrete actions. Could specify more actions like 'parse event payloads', 'validate signatures', or 'process bounce/delivery notifications'. | 2 / 3 |
Completeness | Clearly answers both what ('Receive and verify SendGrid webhooks') and when ('Use when setting up SendGrid webhook handlers, debugging signature verification, or handling email delivery events') with explicit trigger scenarios. | 3 / 3 |
Trigger Term Quality | Good coverage of natural terms: 'SendGrid', 'webhooks', 'webhook handlers', 'signature verification', 'email delivery events'. These are terms users would naturally use when working with SendGrid integrations. | 3 / 3 |
Distinctiveness Conflict Risk | Very specific niche - SendGrid webhooks are distinct from general webhook handling or other email services. The combination of 'SendGrid' + 'webhooks' + 'signature verification' creates clear, non-conflicting triggers. | 3 / 3 |
Total | 11 / 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 well-crafted skill that provides immediately actionable code for SendGrid webhook verification with excellent progressive disclosure. The main content is concise and executable, with appropriate references to deeper materials. Minor improvement could be made by adding explicit validation/testing steps for the webhook setup process.
Suggestions
Add a brief validation checklist or testing steps (e.g., 'Test with SendGrid's test webhook feature before going live', 'Verify signature rejection works by tampering with payload')
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is lean and efficient, providing executable code without explaining basic concepts Claude already knows. No unnecessary padding about what webhooks are or how ECDSA works conceptually. | 3 / 3 |
Actionability | Provides fully executable, copy-paste ready code for both manual verification and SDK usage. Includes complete Express middleware examples with proper header extraction and error handling. | 3 / 3 |
Workflow Clarity | The code examples show the verification flow clearly, but lacks explicit validation checkpoints or error recovery guidance. For webhook handling (which can involve data loss if misconfigured), explicit steps for testing/validating the setup would strengthen this. | 2 / 3 |
Progressive Disclosure | Excellent structure with quick-start code in the main file and clear one-level-deep references to detailed materials (overview.md, setup.md, verification.md, examples/). Navigation is well-signaled and organized. | 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.