Agent skill · software engineering · jeremylongshore
langfuse-webhooks-events
Configure Langfuse webhooks for prompt change notifications and event-driven
Why this skill is useful
Adds specific webhook configuration patterns and event handling for Langfuse that the AI wouldn't reliably generate on its own.
What it needs
Requires next installed locally. Requires langfuse account access. About 4k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Langfuse Webhooks & Events Overview Configure Langfuse webhooks to receive notifications on prompt version changes. Langfuse supports webhook events for prompt lifecycle: Created, Updated (labels/tags changed), and Deleted. Use webhooks to trigger CI/CD pipelines, sync prompts to external systems, or notify teams via Slack. Prerequisites Langfuse Cloud or self-hosted instance HTTPS endpoint to receive webhook POST requests Webhook secret for HMAC signature verification Instructions Step 1: Create Webhook Endpoint Step 2: Configure Webhook in Langfuse 1. Navigate to Prompts > Create Automation > Webhook 2. Enter your endpoint URL: https://your-domain.com/api/webhooks/langfuse 3. Select events to watch: Created, Updated, Deleted 4. Optionally filter to specific prompts 5. Generate and save the webhook secret 6. Click Test to verify connectivity Step 3: Slack Integration Step 4: Trigger CI/CD Pipeline on Prompt Changes Step 5: Webhook Reliability with Retry Queue Webhook Event Reference Event Trigger Use Case ------- --------- ---------- prompt.created New prompt version added Run regression tests, notify team prompt.updated Labels or tags changed Detect production promotions prompt.deleted Prompt version removed Alert on accidental deletion Error Handling Issue Cause Solution ------- ------- ---------- Invalid signature (401) Wrong webhook secret Re-copy secret from Langfuse settings Missed events Handler threw error Queue events, return 200 immediately Duplicate processing Retry without idempotency Dedupe by event + timestamp + promptName Webhook timeout Slow handler Enqueue and process async Output Produce an event contract for each enabled webhook: event name, payload fields used, signature-verification boundary, idempotency key, queue policy, and downstream owner. Include an operational receipt showing that the endpoint acknowledges valid deliveries quickly and rejects invalid signatures without processing the payload. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/langfuse-webhooks-events