How do I install the Langfuse Traces skill?

Run npx skillmds@latest add alberduris/langfuse-traces in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Langfuse Traces skill do?

Query Langfuse traces for debugging LLM calls, analyzing token usage, and investigating workflow executions. Use when debugging AI/LLM behavior, checking trace data, or analyzing observability metrics. It is listed under AI & ML on SkillMD.

Is Langfuse Traces safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Langfuse Traces?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Langfuse Traces free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Langfuse Traces?

alberduris (@alberduris) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Langfuse Traces by alberduris — Agent Skill

Name: Langfuse Traces
Author: alberduris

File contents

Langfuse Traces Skill

Query and analyze Langfuse trace data directly from Claude Code.

Usage

Invoke the query script using the base directory shown above:

bash <base_directory>/scripts/query.sh <command> [options]

Commands

Command	Args	Description
`traces`	[limit] [session_id] [name]	List recent traces
`trace`	trace_id	Get full trace with observations
`observations`	[limit] [trace_id]	List spans/generations
`sessions`	[limit]	List sessions
`summary`	[limit]	Compact one-line-per-trace view

Examples

# List last 20 traces
bash <base_directory>/scripts/query.sh traces 20

# Get specific trace detail
bash <base_directory>/scripts/query.sh trace tr-abc123

# List observations for a trace
bash <base_directory>/scripts/query.sh observations 50 tr-abc123

# Quick summary of recent activity
bash <base_directory>/scripts/query.sh summary 10

Credentials

The script reads credentials from .env.local, .env, or environment variables:

LANGFUSE_PUBLIC_KEY=pk-lf-...
LANGFUSE_SECRET_KEY=sk-lf-...
LANGFUSE_BASE_URL=https://cloud.langfuse.com  # optional, default

Requirements

curl (standard on macOS/Linux)
jq for JSON parsing

Output

All commands return JSON (piped through jq). Use jq filters for specific fields:

bash <base_directory>/scripts/query.sh traces 5 | jq '.data[].name'

Frequently asked questions

Langfuse Traces