К основному содержанию
скилл CX Codex

migrate-to-langfuse — скилл для Claude Code

Скилл migrate-to-langfuse помогает перейти на Langfuse с LangSmith, Arize, Phoenix, Braintrust, Helicone или Promptfoo. Переносит живую трассировку, исторические данные, датасеты, промпты и оценщиков по актуальной документации Langfuse.

MIT 186 установок ★ 344 обновлён 2026-10-23

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add langfuse/skills --skill migrate-to-langfuse -a claude-code
Открыть на GitHub

Что делает migrate-to-langfuse

Скилл проводит пошаговый перенос: сначала интервьюирует (откуда идёт миграция, в какую версию Langfuse, что именно нужно перенести), затем показывает план со сроком и объёмом, потом выполняет по подтверждению. Начинает с пробного образца примерно из 10 трассировок, чтобы проверить корректность в интерфейсе Langfuse перед полным запуском.

Снимает ограничения источника через интеграционные гайды Langfuse и документацию каждой платформы. Поддерживает параллельный запуск обоих экспортёров на время переходного окна — старый удаляется только после вашего подтверждения. Переносит исторические трассировки детерминированными ID, сохраняет исходные временные метки и оценки, отслеживает прогресс в файле состояния для возобновляемых запусков.

Не подходит для обновления версии Langfuse или перемещения между проектами/регионами одной платформы — это задача основного скилла langfuse. Предупреждает, если в исходном аккаунте есть активы вне поддерживаемого списка (дашборды, очереди аннотаций), чтобы вы спланировали их восстановление отдельно.

Какие задачи решает

  • Переключиться на Langfuse с LangSmith, Arize или другой платформы
  • Перенести живую трассировку без перерыва обслуживания
  • Скопировать исторические трассировки с исходными метками времени и оценками
  • Перенести датасеты и промпты в Langfuse
  • Пересоздать оценщиков и пересчитать эксперименты на новых данных

Примеры запросов агенту

  • Перенеси мой проект с LangSmith на Langfuse Cloud с полной историей
  • Помоги спланировать миграцию с Promptfoo и перейди на параллельный экспорт
  • Мигрируй первые 10 трассировок из Phoenix, чтобы я проверил результат

Как установить migrate-to-langfuse

1Через Skills CLI (Vercel)

npx skills add langfuse/skills --skill migrate-to-langfuse -a claude-code

2Вручную: положить файлы

~/.claude/skills/migrate-to-langfuse/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/migrate-to-langfuse/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о migrate-to-langfuse

Как установить migrate-to-langfuse в Claude Code?

Запустите npx skills add langfuse/skills --skill migrate-to-langfuse -a claude-code, затем откройте ~/.claude/skills/migrate-to-langfuse/SKILL.md.

Что делает скилл migrate-to-langfuse?

Автоматизирует перенос с LangSmith, Arize, Phoenix, Braintrust, Helicone или Promptfoo на Langfuse: переводит живую трассировку, исторические данные, датасеты, промпты и оценщиков, начиная с пробного образца и поддерживая параллельный экспорт во время переходного окна.

Скилл подходит для обновления версии Langfuse?

Нет, это только для переноса с другой платформы наблюдения. Обновление версии Langfuse, миграция между проектами или регионами, а также перевод промптов из кода в Langfuse — задачи основного скилла langfuse.

Исходный текст

SKILL.md · MIT
---
name: migrate-to-langfuse
description: >-
  Migrate to Langfuse from another LLM observability/evals platform (LangSmith, Arize AX, Phoenix, Braintrust, Helicone, Promptfoo, ...). A one-off vendor switch: live tracing cutover plus transfer of historical traces, datasets, prompts, and evaluators. Not for anything Langfuse-to-Langfuse — SDK or version upgrades, project/region moves, self-hosted to Cloud — and not for moving in-code prompts into Langfuse; the main langfuse skill covers those.
allowed-tools:
  - WebFetch(domain:langfuse.com)
  - Bash(curl *langfuse.com/*)
---

# Migrate to Langfuse

You are running a one-off vendor switch to Langfuse. Interview first, plan second, execute only after confirmation. Never implement from memory — fetch the current Langfuse docs listed below at execution time.

## 1. Interview (always, before any code)

Ask only what you cannot detect. Inspect the repo first: dependencies and imports usually reveal the source platform (`langsmith`, `arize`, `phoenix`, `braintrust`, `openinference`, old `langfuse` pins).

1. **Source** — which platform and version? Cloud or self-hosted? What access exists: API keys, a database connection, or only the application repo?
2. **Destination** — Langfuse Cloud (which region) or self-hosted? Verify credentials by presence only (e.g. `[ -n "$LANGFUSE_SECRET_KEY" ]`); never ask for secrets in chat, and never access `.env` contents or key values by any means — no shell commands that echo them, no reading `.env` with file tools, no grepping for values. Detect which variable names are set, nothing more.
3. **Scope** — which of: live tracing cutover, historical traces (including their scores, score configs, and custom model definitions), datasets, prompts, evaluators/LLM judges, experiment code. For history: everything or from a cutoff date? Ask what else exists in the source account (dashboards, alerts, annotation queues, saved views, ...). The repo cannot reveal server-side assets. Anything outside the supported list above is not covered by this skill: name it in the scope table as such, so the user plans to recreate it manually instead of discovering the gap after cutover.
4. **Mode** — plan only (a written runbook) or execute?

If the request contradicts the repository (it names a platform that is not present, or asks to upgrade an SDK that is not installed), stop and reconcile with the user first — never reinterpret the request as a different migration and start executing it.

Present the resulting plan (scope table plus order of operations) and get the user's confirmation before changing any file. However imperative the request sounds, it does not authorize removing or replacing the existing vendor's instrumentation before the plan is confirmed.

## 2. Defaults to apply

- **Live cutover first.** Historical data migration is optional and billed as new ingestion in Langfuse — say so before migrating history. If the source already emits OTel/OpenInference spans, add Langfuse as a second exporter on the existing instrumentation instead of re-instrumenting; the old destination is dropped only when the parallel-run window below closes.
- **Datasets and prompts copy. Evaluators and judges are recreated.** Experiment code is rewritten and re-run against the migrated dataset; never import old experiment scores.
- **Test on a sample before the full run.** Migrate ~10 traces first, link the destination traces, and wait for the user to confirm they look correct before migrating everything.
- **Show progress** (pages/counts) during long runs and make re-runs resumable: track sent source IDs in a state file and skip them, re-sending the same IDs creates duplicate observations (see references/reingest-history.md).
- **Parallel-run window.** Keep the old exporter until the user confirms the destination data, then remove it in a separate, explicit step. This binds the implementation, not just the plan: after your edits, the old vendor's exporter/instrumentation must still be present and active. Before showing a diff, re-check that no vendor import, register call, exporter endpoint, or exporter env var was deleted or repointed. Implement parallel export as **one instrumentation with two exporters** (both span processors on the same tracer provider) — never instrument the application twice. Duplicated generations and double-counted costs in the destination are the symptom of a second capture path.

## 3. Route by scenario

Fetch and follow; do not reproduce their content:

| Scenario | Source of truth |
| --- | --- |
| Vendor with a published guide (LangSmith, Arize AX, Phoenix, Braintrust, Helicone, Promptfoo, ...) | `https://langfuse.com/resources/engineering/migrate-from-<vendor>.md` — check `https://langfuse.com/llms.txt` for the current list |
| Vendor without a published guide, or historical data from any vendor | references/reingest-history.md, plus the vendor's own export API docs |

Historical-trace reingestion is never improvised: read references/reingest-history.md in full before writing or running any reingestion code, even when a vendor guide exists. The vendor guide covers extraction; the reference governs reingestion — deterministic IDs, raw OTLP payloads, original timestamps, the cutover-time bound, and the warning that imported history is billed as new ingestion.

If the source turns out to be another Langfuse deployment (an older version, a different project, region, or host), stop — that is not a vendor switch. Point the user to the main langfuse skill (its SDK-upgrade and v4-migration references) and the [project-to-project migration cookbook](https://langfuse.com/guides/cookbook/example_data_migration).

For the live instrumentation cutover, use the integration guide matching the user's framework or SDK from https://langfuse.com/llms.txt. For deep Langfuse-side work (prompt creation, dataset APIs, experiment code), defer to the main langfuse skill if installed.

## 4. Verify and close

- Sample check confirmed by the user in the destination UI before the full run.
- Before asking the user to confirm a live-cutover sample, audit it yourself via the Langfuse API or CLI: one trace per request; the root span named after the agent/app (and the trace named after the root); every span type present (generations **and** tool/chain spans); each LLM call captured exactly once; token usage and cost populated. Only then send the user the trace links.
- Counts match per migrated data type (source vs destination); report a summary table including failures.
- Live traffic arrives in the destination; the old exporter is removed only after the parallel-run window the user chose.
- The close-out summary accounts for every scope-table row from the interview, including the ones marked skipped or not covered — nothing is silently dropped.

© langfuse · MIT · langfuse/skills

Похожие скиллы

Все скиллы по теме «ИИ и ML» →
arize-migrate-langsmith arize Скилл arize-migrate-langsmith для Claude Code переносит исторические трейсы, датасеты и промпты из LangSmith в Arize AX. Запускается при смене платформы наблюдаемости LLM. CX Codex +1 416установок langfuse davila7 Помогает внедрить трейсинг, оценку и учёт расходов LLM через Langfuse. Пригодится при отладке цепочек OpenAI и LangChain в продакшене. CX Codex +1 78установок langfuse-observability Langfuse Плагин langfuse-observability для Claude Code отправляет телеметрию сессий в Langfuse. Он записывает запросы, вызовы инструментов и данные о генерациях для мониторинга и отладки. ★ 32звёзд репо arize-migrate-langfuse arize Скилл arize-migrate-langfuse для Claude Code переносит исторические трассировки, датасеты и промпты из Langfuse в Arize AX. Мигрирует наблюдаемость LLM с сохранением связей и меток. CX Codex +1 417установок Langfuse MCP avivsinai Подключает телеметрию Langfuse к ИИ-ассистентам для поиска сбоев в трейсах и разбора сессий. Пригодится при отладке работы моделей прямо в консоли. CX Codex +1 ★ 112звёзд репо observability assistant-ui Скилл observability подключает Langfuse, LangSmith или Helicone к бэкенд-роутам assistant-ui на AI SDK и рисует собранные спаны через экспериментальный @assistant-ui/react-o11y. CX Codex +1 4 200установок

Из того же набора3

Спонсоры проекта

Компании, которые помогают держать аналитику открытой