langfuse — плагин для Claude Code: трассировка и промпты
Скиллы для работы с Langfuse из Claude: запросы к трейсам, промптам, датасетам и оценкам через API.
/plugin install langfuse@claude-plugins-official
/plugin marketplace add anthropics/claude-plugins-community
/plugin install langfuse@claude-community
/plugin marketplace add anthropics/claude-plugins-officialЧто делает langfuse
Плагин ставит в Claude два скилла. Основной langfuse даёт агенту доступ к API Langfuse: он ищет и меняет трейсы, промпты, датасеты и оценки, подтягивает документацию и старается делать это по принятым практикам. Второй, migrate-to-langfuse, нужен при переезде с другой платформы наблюдаемости и оценки — LangSmith, Arize, Braintrust и подобных. Сначала он спрашивает про объём работ, потом ведёт перенос живой трассировки и исторических данных: трейсов, датасетов, промптов и оценщиков.
Перед началом нужен аккаунт Langfuse — облачный или развёрнутый у себя — и ключи API. Они лежат в проекте в разделе настроек API Keys. Ключи задаются переменными окружения: LANGFUSE_PUBLIC_KEY, LANGFUSE_SECRET_KEY и LANGFUSE_BASE_URL. Без них агент до API не дотянется, так что это первое, что стоит проверить.
Скиллы подхватываются сами, когда задача совпадает: настройка трассировки в проекте, аудит существующей инструментации, перенос промптов в управление промптами Langfuse, запросы к трейсам и датасетам, справка по SDK и интеграциям. Есть и сценарий с гейтами экспериментов в CI/CD через langfuse/experiment-action.
Какие задачи решает
- настроить трассировку Langfuse в проекте
- найти и разобрать трейсы через API
- перенести промпты в управление промптами Langfuse
- проверить существующую инструментацию на ошибки
- переехать с LangSmith или Braintrust на Langfuse
Примеры запросов агенту
- настрой трассировку Langfuse в этом проекте
- покажи последние трейсы и разбери, где падают запросы
- перенеси промпты в Langfuse prompt management
Как установить langfuse
Через маркетплейс плагинов
/plugin install langfuse@claude-plugins-official/plugin marketplace add anthropics/claude-plugins-community/plugin install langfuse@claude-community/plugin marketplace add anthropics/claude-plugins-officialПо шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой
Вопросы о langfuse
Как установить langfuse в Claude?
Через маркетплейс: сначала /plugin marketplace add anthropics/claude-plugins-official, затем /plugin install langfuse@claude-plugins-official.
Что делает плагин langfuse?
Добавляет два скилла: основной для работы с API Langfuse — трейсы, промпты, датасеты, оценки — и скилл миграции с других платформ наблюдаемости.
Что нужно для работы плагина?
Аккаунт Langfuse и ключи API в переменных окружения LANGFUSE_PUBLIC_KEY, LANGFUSE_SECRET_KEY, LANGFUSE_BASE_URL.
Исходный текст
SKILL.md · MIT
<img width="2400" height="600" alt="hero-b" src="https://github.com/user-attachments/assets/c177a82d-334b-495c-81cb-9df69c521123" /> # Langfuse Skills [Agent Skills](https://github.com/anthropics/skills) that teach AI coding assistants (Claude Code, Cursor, etc.) how to work with [Langfuse](https://langfuse.com) — the open-source LLM engineering platform for tracing, prompt management, and evaluation. ## Skills | Skill | Description | | --------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | | [langfuse](./skills/langfuse) | Main skill to work with Langfuse. Query and manage traces, prompts, datasets, and scores via the Langfuse API; look up documentation; do things with best practices in mind. | | [migrate-to-langfuse](./skills/migrate-to-langfuse) | Migrate from another LLM observability/evals platform (LangSmith, Arize, Braintrust, etc.) to Langfuse. Interviews you about scope, then handles the live tracing cutover and transfer of historical traces, datasets, prompts, and evaluators. | ## Installation ### Cursor Plugin Install as a [Cursor plugin](https://cursor.com/docs/plugins): ``` /add-plugin langfuse ``` ### skills CLI Install via the [skills CLI](https://github.com/vercel-labs/skills): ```bash npx skills add langfuse/skills --skill "langfuse" ``` ### Manual symlink Clone this repo and symlink the skill into your agent's skills directory: ```bash git clone https://github.com/langfuse/skills.git /path/to/langfuse-skills ln -s /path/to/langfuse-skills/skills/langfuse /path/to/skills-directory/langfuse ``` ## Prerequisites You need a Langfuse account ([cloud](https://cloud.langfuse.com) or [self-hosted](https://langfuse.com/docs/deployment/self-host)) and API keys: ```bash export LANGFUSE_PUBLIC_KEY=pk-lf-... export LANGFUSE_SECRET_KEY=sk-lf-... export LANGFUSE_BASE_URL=https://cloud.langfuse.com # or https://us.cloud.langfuse.com, or self-hosted URL ``` API keys are found in your Langfuse project under **Settings > API Keys**. ## Usage Once installed, the agent will automatically use these skills when relevant — for example: - Setting up Langfuse tracing in a project - Setting up CI/CD experiment gates with `langfuse/experiment-action` - Auditing existing instrumentation - Preparing an application and Langfuse project for the v4 platform migration - Migrating prompts to Langfuse prompt management - Querying traces, prompts, or datasets via the API - Looking up Langfuse docs, SDK usage, or integration guides ## Contributing Want to improve a skill or add a new one? See [CONTRIBUTING.md](./CONTRIBUTING.md). ## Feedback & Requests Something not working as expected, or want a new skill? [Start a discussion](https://github.com/langfuse/skills/discussions/new?category=ideas-improvements).
© Langfuse · MIT · langfuse/skills
