Agent skill · software engineering · jeremylongshore
langfuse-prod-checklist
Langfuse production readiness checklist and verification.
Why this skill is useful
Adds a pre-deployment verification script and specific configuration patterns for Langfuse that enhance deployment readiness.
What it needs
Requires npm 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 Production Checklist Overview Comprehensive checklist for deploying Langfuse observability to production with verified configuration, error handling, graceful shutdown, monitoring, and a pre-deployment verification script. Prerequisites Development and staging testing completed Production Langfuse project created with separate API keys Secret management solution in place Production Configuration Recommended SDK Settings Production Error Handling Pre-Deployment Verification Script Production Checklist Authentication & Security [ ] Production API keys created (separate from dev/staging) [ ] Keys stored in secret manager (not env files or code) [ ] Key prefix validated at startup (pk-lf- / sk-lf-) [ ] PII scrubbing enabled on trace inputs/outputs [ ] Secret scanning in CI/CD pipeline SDK Configuration [ ] Singleton client pattern (no per-request instantiation) [ ] Batch size tuned (flushAt: 25-50) [ ] Flush interval set (flushInterval: 5000) [ ] Request timeout configured (requestTimeout: 15000) Reliability [ ] Graceful shutdown on SIGTERM/SIGINT [ ] All spans end in try/finally (v3) or use observe/startActiveObservation (v4+) [ ] Tracing errors caught -- never crash the app [ ] Circuit breaker for sustained failures Monitoring [ ] Trace creation success/failure logged [ ] Flush latency tracked [ ] Rate limit errors monitored [ ] Dashboard alerts for quality score regression Operations [ ] Runbook documented for Langfuse outages [ ] Fallback behavior defined (app works without Langfuse) [ ] Data retention policy configured [ ] Log rotation includes redaction of API keys Instructions Run the checklist against one named environment and attach the verification script output to the deployment record. Resolve every failed required item or record an explicit time-bounded exception with an owner and rollback plan. Run the check again after changing SDK configuration, secrets, or deployment topology. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/langfuse-prod-checklist