webhook-handler-patternslisted
Install: claude install-skill martineserios/thebrana
# Webhook Handler Patterns
## When to Use This Skill
- Following the correct webhook handler order (verify → parse → handle idempotently)
- Implementing idempotent webhook handlers
- Handling errors and configuring retry behavior
- Understanding framework-specific gotchas (raw body, middleware order)
- Building production-ready webhook infrastructure
## Resources
### Handler Sequence
- references/handler-sequence.md (upstream `references/handler-sequence.md`, not installed locally) - Verify first, parse second, handle idempotently third
### Best Practices
- references/idempotency.md (upstream `references/idempotency.md`, not installed locally) - Prevent duplicate processing
- references/error-handling.md (upstream `references/error-handling.md`, not installed locally) - Return codes, logging, dead letter queues
- references/retry-logic.md (upstream `references/retry-logic.md`, not installed locally) - Provider retry schedules, backoff patterns
### Framework Guides
- references/frameworks/express.md (upstream `references/frameworks/express.md`, not installed locally) - Express.js patterns and gotchas
- references/frameworks/nextjs.md (upstream `references/frameworks/nextjs.md`, not installed locally) - Next.js App Router patterns
- references/frameworks/fastapi.md (upstream `references/frameworks/fastapi.md`, not installed locally) - FastAPI/Python patterns
## Quick Reference
### Handler Sequence
1. **Verify signature first** — Use raw body; reject invalid requests