<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. |

## 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/anthropics/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 install