Skip to content

clerk-webhooks: align with Clerk skill, SDKs, standardwebhooks, Hookdeck#34

Merged
leggetter merged 1 commit intomainfrom
chore/clerk-webhook-update
Feb 6, 2026
Merged

clerk-webhooks: align with Clerk skill, SDKs, standardwebhooks, Hookdeck#34
leggetter merged 1 commit intomainfrom
chore/clerk-webhook-update

Conversation

@leggetter
Copy link
Collaborator

Changes

  • SKILL.md: Reorder sections to match other provider skills. Move Clerk-specific content to references/patterns.md. Common Event Types as table. Document CLERK_WEBHOOK_SIGNING_SECRET and CLERK_WEBHOOK_SECRET. Local Development: Hookdeck CLI only (no ngrok).
  • references/patterns.md: New file — prerequisite, official docs links, Quick Start, When to Sync, Key Patterns, queue/async and Hookdeck Event Gateway note, Common Pitfalls.
  • references/setup.md: Document both env var names.
  • references/verification.md: Next.js use @clerk/backend/webhooks; Express use standardwebhooks package; remove Svix library section.
  • Express example: Verify with standardwebhooks package (map svix-* to webhook-* headers). Add standardwebhooks dependency. Map WebhookVerificationError messages for tests.
  • Next.js example: Use verifyWebhook from @clerk/backend/webhooks. Add @clerk/backend and svix. Map verification error messages for tests.
  • Tests: Express and Next.js assertions updated for SDK/standardwebhooks error messages.

Made with Cursor

- SKILL.md: Reorder sections to match other provider skills. Add Documentation Reference, Quick Start, When to Sync, Key Patterns, Webhook Reliability, Common Pitfalls in references/patterns.md. Common Event Types as table. Env vars: document CLERK_WEBHOOK_SIGNING_SECRET and CLERK_WEBHOOK_SECRET. Local Development: Hookdeck CLI only (no ngrok).
- references/patterns.md: New file with prerequisite, official docs links, Quick Start, When to Sync, Key Patterns, queue/async note and Hookdeck Event Gateway note, Common Pitfalls.
- references/setup.md: Document CLERK_WEBHOOK_SIGNING_SECRET and CLERK_WEBHOOK_SECRET.
- references/verification.md: Next.js use @clerk/backend/webhooks; Express use standardwebhooks package; remove Svix library section.
- Express example: Verify with standardwebhooks package (map svix-* to webhook-* headers). Add standardwebhooks dependency. Map WebhookVerificationError messages for tests.
- Next.js example: Use verifyWebhook from @clerk/backend/webhooks. Add @clerk/backend and svix. Map verification error messages for tests.
- Tests: Express and Next.js assertions updated for SDK/standardwebhooks error messages.

Co-authored-by: Cursor <cursoragent@cursor.com>
@leggetter leggetter merged commit 4d37059 into main Feb 6, 2026
6 checks passed
@leggetter leggetter deleted the chore/clerk-webhook-update branch February 6, 2026 19:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant