Agent skill · software engineering · jeremylongshore
langfuse-migration-deep-dive
Execute complex Langfuse migrations including data migration and platform
Why this skill is useful
Adds executable scripts for complex Langfuse migrations that aren't covered in public documentation.
What it needs
Requires npm installed locally. Requires langfuse account access. About 5k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Langfuse Migration Deep Dive Current State !npm list langfuse @langfuse/client 2>/dev/null head -5 echo 'No langfuse packages' Overview Comprehensive guide for complex migrations: cloud-to-self-hosted, LangSmith-to-Langfuse, cross-instance data migration, and zero-downtime dual-write patterns. Prerequisites Understanding of source and target Langfuse instances API keys for both source and target Git branch for migration work Rollback plan documented Migration Scenarios Scenario Complexity Downtime Data Loss Risk ---------- ----------- ---------- ---------------- Cloud to Cloud (different project) Low None None Cloud to Self-hosted Medium Minutes Low Self-hosted to Cloud Medium Minutes Low LangSmith to Langfuse High Hours Medium SDK v3 to v4+ (no data migration) Low None None Instructions Step 1: Export Data from Source Instance Step 2: Import Data to Target Instance Step 3: Dual-Write for Zero-Downtime Migration Write traces to both instances during transition: Step 4: Validate Migration Step 5: Cutover and Cleanup Rollback Plan Error Handling Issue Cause Solution ------- ------- ---------- Export timeout Too much data Paginate with smaller page sizes Import duplicates Re-running import Use idempotent creates with unique names Dual-write divergence One instance failing Monitor both, alert on variance > 5% Missing prompts Not exported Export prompts before datasets Output Produce a migration receipt with source/target environments, exported object counts, dual-write variance, cutover time, rollback window, and validation owner. Do not record live keys or trace payloads in the receipt. Examples Export prompts and datasets from a staging source, import them into a staging target, and compare counts before enabling dual-write. During cutover, retain the source for the rollback window and switch back immediately if trace variance exceeds the agreed limit. Resources Self-Hosting Guide Upgrade Guide API Reference v3 to v4 Migration
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/langfuse-migration-deep-dive--c67a74