Langfuse Skills를 오픈소스로 공개합니다 — 코딩 에이전트에서 LLM 옵저버빌리티를 다루다

이전에 Claude Code × Langfuse로 동족 디버깅 환경을 만든 이야기를 소개했습니다. 사내에서 사용하던 Langfuse 연동 스킬을 이번에 langfuse-skills로 오픈소스 공개했습니다.

왜 공개했나

이전 글을 공개한 후, "우리 프로젝트에서도 쓰고 싶다"는 반응을 많이 받았습니다.

LLM 앱을 개발하다 보면 Langfuse 대시보드와 에디터를 오가는 게 일상이 됩니다. 트레이스를 확인하려고 브라우저를 열고, ID를 복사하고, 중첩된 JSON을 뒤지는 작업. 이걸 코딩 에이전트에 맡길 수 있다면? 이런 생각은 많은 개발자에게 공통된 것이었습니다.

그래서 사내 스킬을 범용 패키지로 정리하고, Vercel의 skills 에코시스템에 대응하는 형태로 릴리스했습니다.

설치

한 줄이면 끝입니다.

# Claude Code
npx skills add neuradex/langfuse-skills -a claude-code

# Cursor
npx skills add neuradex/langfuse-skills -a cursor

# Codex / Windsurf / Cline / Roo Code 등도 지원
npx skills add neuradex/langfuse-skills -a <agent>

환경 변수를 설정하면 준비 완료입니다.

export LANGFUSE_PUBLIC_KEY="pk-lf-..."
export LANGFUSE_SECRET_KEY="sk-lf-..."

할 수 있는 것

10개의 스킬을 제공합니다.

트레이스·세션 분석: langfuse-trace-list / langfuse-trace-view / langfuse-session-list / langfuse-session-view / langfuse-observation-view — 지연 트레이스 진단, 대화 품질 분석, 비용 모니터링을 자연어로 수행할 수 있습니다.

프롬프트 관리: langfuse-prompt-list / langfuse-prompt-view / langfuse-prompt-upsert — 프롬프트 확인부터 개선·반영까지 에이전트와의 대화로 완결됩니다. 문제 원인이 프롬프트에 있다고 파악되면 그 자리에서 수정하고 development 레이블로 저장할 수 있습니다.

모델·비용 관리: langfuse-model-list / langfuse-model-upsert — 모델 가격 설정을 확인하고 업데이트할 수 있습니다.

실제 사용법

이전 글에서 소개한 워크플로우를 그대로 사용할 수 있습니다.

나: "이 트레이스가 느려. 원인 좀 찾아봐"
에이전트: (langfuse-trace-view로 트레이스 조회)
         "입력 토큰이 12,000을 초과합니다.
          시스템 프롬프트의 few-shot 예시가 과다합니다.
          3개에서 1개로 줄이는 걸 제안합니다."
나: "프롬프트 고쳐줘"
에이전트: (langfuse-prompt-view로 현재 프롬프트 조회)
         (개선안 제시)
나: "OK, 반영해"
에이전트: (langfuse-prompt-upsert로 저장)
         "development 레이블로 저장했습니다."

트레이스 분석부터 프롬프트 수정까지, 에디터를 벗어나지 않고 완료됩니다.

마무리

langfuse-skills는 LLM 옵저버빌리티를 코딩 에이전트의 워크플로우에 통합하는 스킬 패키지입니다.

GitHub: neuradex/langfuse-skills
지원 에이전트: Claude Code, Cursor, Codex, Windsurf, Cline, Roo Code, GitHub Copilot
라이선스: MIT

LLM 앱 개발·운영에서 "대시보드와 에디터 왔다 갔다"에 지친 분이라면 한번 써보세요.