Agent skill · software engineering · jeremylongshore
langfuse-upgrade-migration
Upgrade Langfuse SDK versions and migrate between API changes.
Why this skill is useful
Adds detailed migration scripts and instructions for upgrading between Langfuse SDK versions, which are not publicly documented.
What it needs
Requires npm, pip installed locally. About 4k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Langfuse Upgrade & Migration Current State !npm list langfuse @langfuse/client @langfuse/tracing @langfuse/otel 2>/dev/null head -10 echo 'No langfuse packages found' !pip show langfuse 2>/dev/null grep -E "Name Version" echo 'Python langfuse not installed' Overview Step-by-step guide for upgrading the Langfuse SDK across major versions. Covers v3 to v4 (OTel rewrite), v4 to v5, breaking changes, and automated codemods. Prerequisites Existing Langfuse integration Test suite covering traced operations Git branch for the upgrade Version Roadmap SDK Package Architecture Status ----- --------- ------------- -------- v3 langfuse (single) Custom, Langfuse class Legacy v4 @langfuse/client, @langfuse/tracing, @langfuse/otel OpenTelemetry-based Stable v5 @langfuse/client, @langfuse/tracing, @langfuse/otel OpenTelemetry + improvements Latest Instructions Step 1: Check Current Version and Plan Step 2: v3 to v4 Migration (TypeScript) This is the biggest migration -- v4 rewrites tracing on OpenTelemetry. 2a. Install new packages: 2b. Update initialization: 2c. Update tracing calls: 2d. Update OpenAI wrapper: 2e. Update environment variable: 2f. Update prompt management: 2g. Update shutdown: Step 3: Python SDK Migration (v2 to v3) Step 4: Run Tests and Verify Step 5: Remove Old Package Breaking Changes Quick Reference Change v3 v4+ -------- ------- ------- Package langfuse @langfuse/client + @langfuse/tracing + @langfuse/otel Client class Langfuse LangfuseClient Base URL env LANGFUSEHOST LANGFUSEBASEURL Tracing langfuse.trace() / .span() / .generation() startActiveObservation() / observe() Flush langfuse.flushAsync() sdk.shutdown() Prompt version getPrompt(name, version) prompt.get(name, { version }) OpenAI import { observeOpenAI } from "langfuse" import { observeOpenAI } from "@langfuse/openai" Error Handling Error Cause Solution ------- ------- ---------- Cannot find module '@langfuse/tracing' Package not installed npm install @langfuse/tracing @langfuse/otel @opentelemetry/sdk …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/langfuse-upgrade-migration