shopify-webhooks
Receive and verify Shopify webhooks. Use when setting up Shopify webhook handlers, debugging signature verification, or handling store events like orders/create, products/update, or customers/create.
92
88%
Does it follow best practices?
Impact
100%
1.35xAverage 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 strong skill description with excellent trigger terms and completeness. The explicit 'Use when' clause with specific Shopify event types makes it highly discoverable. The only minor weakness is that the capability list could be slightly more comprehensive beyond just 'receive and verify'.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (Shopify webhooks) and two actions (receive, verify), but doesn't comprehensively list capabilities like parsing payloads, handling retries, or specific verification methods. | 2 / 3 |
Completeness | Clearly answers both what (receive and verify Shopify webhooks) and when (explicit 'Use when' clause covering setup, debugging, and handling specific store events). | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural terms: 'Shopify webhooks', 'webhook handlers', 'signature verification', 'store events', and specific event types like 'orders/create', 'products/update', 'customers/create' that users would naturally mention. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with Shopify-specific terminology and webhook event names; unlikely to conflict with generic webhook skills or other e-commerce integrations. | 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 webhook handling code for Shopify. The content is concise, executable, and well-organized with appropriate progressive disclosure to detailed examples. Minor improvement could be made in workflow clarity by adding explicit error recovery guidance for common failure scenarios.
Suggestions
Add explicit error recovery steps for signature verification failures (e.g., logging, alerting, debugging steps)
Include a brief troubleshooting checklist for common issues like raw body parsing problems or secret mismatches
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is lean and efficient, providing executable code without explaining basic concepts Claude already knows. Every section serves a clear purpose with no padding or unnecessary context. | 3 / 3 |
Actionability | Provides fully executable, copy-paste ready code for both JavaScript/Express and Python/FastAPI. Includes complete signature verification functions, handler setup, and specific commands for local development. | 3 / 3 |
Workflow Clarity | The code examples show the verification-then-parse sequence clearly, but lacks explicit validation checkpoints or error recovery steps. The 5-second timeout note is helpful but there's no guidance on what to do if verification fails beyond logging. | 2 / 3 |
Progressive Disclosure | Excellent structure with quick-start code upfront, clear references to example implementations, and well-organized links to reference materials. Navigation is one-level deep and clearly signaled. | 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.