# Langfuse Prompt Upsert

> Create or update Langfuse prompt with development label. Use when creating new prompts, updating existing prompts, or improving prompt content.

- Skill: `neuradex/langfuse-prompt-upsert` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add neuradex/langfuse-prompt-upsert`
- Raw SKILL.md: https://api.skillmd.com/api/skills/neuradex/langfuse-prompt-upsert/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- License: MIT
- Author: neuradex (https://skillmd.com/u/neuradex)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/neuradex/langfuse-prompt-upsert

---


# Langfuse Prompt Upsert

Create or update a Langfuse prompt and attach the `development` label.
- If the prompt does not exist: creates a new one (v1)
- If the prompt exists: creates a new version

## Setup

Set the following environment variables before use:

| Variable | Required | Description |
|----------|----------|-------------|
| `LANGFUSE_PUBLIC_KEY` | Yes | Langfuse public key |
| `LANGFUSE_SECRET_KEY` | Yes | Langfuse secret key |
| `LANGFUSE_HOST` or `LANGFUSE_BASE_URL` | No | Langfuse host URL (default: `https://us.cloud.langfuse.com`) |

## When to Use

- Creating a new prompt
- Improving/updating an existing prompt
- Changing prompt content

## Steps

### 1. Check Current Prompt (for updates)

```bash
npx tsx scripts/langfuse-prompt-view.ts <prompt-name> --label=development
```

### 2. Prepare New Prompt Content

Use AskUserQuestion to confirm or propose new prompt content.

### 3. Create/Update Prompt

**Method A: Pipe directly (recommended)**

```bash
cat << 'EOF' | npx tsx scripts/langfuse-prompt-upsert.ts <prompt-name>
Prompt content goes here...
EOF
```

**Method B: Via file**

```bash
# Save to /tmp/new-prompt.txt using the Write tool, then:
npx tsx scripts/langfuse-prompt-upsert.ts <prompt-name> /tmp/new-prompt.txt
```

### 4. Verify Result

```bash
npx tsx scripts/langfuse-prompt-view.ts <prompt-name> --label=development
```

## Template Variables

Use `$variableName` format for dynamic values in prompts:

| Variable | Purpose |
|----------|---------|
| `$title` | Title |
| `$content` | Main content |
| `$searchResult` | Search results |
| `$conversation` | Conversation history |
| `$userQuestion` | User's question |

Variables are replaced in code with `.replace('$title', value)`.

## Notes

- This skill only attaches the `development` label
- Attaching the `production` label should be done manually in the Langfuse UI
- The existing `development` label is automatically moved to the new version