Webhook Debugger

Stop guessing why webhooks fail. This skill gives your agent a complete webhook debugging toolkit: spin up a local capture server, inspect payloads, replay events, validate HMAC signatures (Stripe, GitHub, Shopify, generic), send test events, and diagnose delivery failures.

What You Get

4 ready-to-run scripts (Node.js, zero npm dependencies):

| Script | What It Does | |--------|-------------| | webhook-listener.mjs | Local HTTP server that captures all incoming webhooks to disk with full headers, body, and metadata | | webhook-verify.mjs | Validates HMAC signatures for Stripe, GitHub, Shopify, and generic HMAC-SHA256 | | webhook-test.mjs | Sends test payloads with provider-specific event templates | | webhook-diagnose.mjs | Checks DNS, TLS, response time, status codes, and idempotency |

Why This Is Worth $2

• Zero setup — runs on any machine with Node.js, no npm install needed
• Provider-aware — knows Stripe, GitHub, and Shopify signature formats out of the box
• Capture + Replay — save real webhook events, replay them during development
• Diagnosis mode — checks 7 common failure points before you waste time debugging code
• Pairs with tunneling — one command to expose locally via cloudflared or ngrok

Common Use Cases

• Testing Stripe payment webhooks locally before deploying
• Debugging GitHub Actions webhook delivery failures
• Validating signature verification code works correctly
• Capturing real production webhook payloads for test fixtures
• Diagnosing why webhooks silently fail (DNS, TLS, timeout, redirect)

Includes complete SKILL.md with all 4 scripts, usage examples, anti-patterns guide, and integration tips.