paddle-webhooks
Receive and verify Paddle webhooks. Use when setting up Paddle webhook handlers, debugging signature verification, or handling subscription events like subscription.created, subscription.canceled, or transaction.completed.
92
88%
Does it follow best practices?
Impact
100%
1.23xAverage 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 that clearly identifies its niche (Paddle webhooks) with explicit trigger guidance and specific event names. The main weakness is that the capability description could be more comprehensive in listing concrete actions beyond 'receive and verify'. Overall, it effectively enables Claude to select this skill when users mention Paddle-related webhook tasks.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (Paddle webhooks) and some actions ('receive', 'verify', 'handling subscription events'), but doesn't comprehensively list all concrete actions like parsing payloads, extracting event data, or responding to webhooks. | 2 / 3 |
Completeness | Clearly answers both what ('Receive and verify Paddle webhooks') and when ('Use when setting up Paddle webhook handlers, debugging signature verification, or handling subscription events') with explicit trigger scenarios. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural terms users would say: 'Paddle webhooks', 'webhook handlers', 'signature verification', and specific event names like 'subscription.created', 'subscription.canceled', 'transaction.completed' that users would naturally mention. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with Paddle-specific terminology and event names. Unlikely to conflict with generic webhook skills or other payment provider integrations due to explicit Paddle branding and specific event types. | 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 high-quality skill that provides immediately actionable webhook handling code for Paddle. The content is well-organized with executable examples, clear event type documentation, and appropriate references to detailed materials. The only weakness is the lack of explicit validation checkpoints for error recovery in the workflow.
Suggestions
Add explicit validation/debugging steps for when signature verification fails (e.g., 'If verification fails: 1. Check PADDLE_WEBHOOK_SECRET matches dashboard, 2. Verify raw body middleware is applied, 3. Log the signature header format')
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is lean and efficient, providing executable code without explaining what webhooks are or how signature verification works conceptually. Every section serves a purpose with no padding. | 3 / 3 |
Actionability | Provides complete, copy-paste ready code for both Express and FastAPI implementations. Includes specific environment variable names, CLI commands for local development, and a comprehensive event type reference table. | 3 / 3 |
Workflow Clarity | The code examples show the verification-then-handle sequence clearly, but there's no explicit validation checkpoint or error recovery workflow. The 5-second response requirement is noted but not integrated into a clear workflow with feedback loops. | 2 / 3 |
Progressive Disclosure | Excellent structure with quick-start code inline and clear one-level-deep references to examples/, references/, and external documentation. The related skills section provides good navigation without cluttering the main content. | 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.