Beam Debug Issue Tasks

Debug failed/issue tasks from Beam.ai using Langfuse traces. Load when user says "debug issue tasks", "check failed tasks", "why did task fail", "task errors", "debug agent", or needs to investigate task failures.

8 stars 3 forksProductivity & Notes Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add Freddy-CHEN-ux/00_claude_skills

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add Freddy-CHEN-ux/00_claude_skills --skill beam-debug-issue-tasks
Manual install
git clone --depth 1 https://github.com/Freddy-CHEN-ux/00_claude_skills.git /tmp/00_claude_skills
mkdir -p ~/.claude/skills
cp -r /tmp/00_claude_skills/skills/beam-debug-issue-tasks ~/.claude/skills/beam-debug-issue-tasks

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Beam Debug Issue Tasks

**Debug failed Beam.ai tasks using Langfuse traces.**

## When to Use

- Diagnose why a task failed, stopped, or needs input
- Find root cause from Langfuse trace reasoning
- Generate debug reports for documentation or handoff

---

## Prerequisites

`.env` file at project root:

```
# Beam.ai - BID instance
BEAM_API_KEY=your_bid_api_key
BEAM_WORKSPACE_ID=your_bid_workspace_id

# Beam.ai - Prod instance
BEAM_API_KEY_PROD=your_prod_api_key
BEAM_WORKSPACE_ID_PROD=your_prod_workspace_id

# Langfuse (self-hosted)
LANGFUSE_PUBLIC_KEY=pk-lf-...
LANGFUSE_SECRET_KEY=sk-lf-...
LANGFUSE_HOST=https://tracing.beamstudio.ai
```

**Dependencies**: `pip install requests python-dotenv`

---

## Quick Start

```bash
# List issue tasks (default: last 1 day, BID workspace)
python 03-skills/beam-debug-issue-tasks/scripts/debug_issue_tasks.py <agent_id>

# Debug specific task with full trace analysis
python 03-skills/beam-debug-issue-tasks/scripts/debug_issue_tasks.py <agent_id> --task-id <task_id>

# Use prod workspace
python 03-skills/beam-debug-issue-tasks/scripts/debug_issue_tasks.py <agent_id> --workspace prod
```

---

## Workspaces

| Workspace | API Endpoint | Langfuse Project |
|-----------|--------------|------------------|
| `bid` (default) | api.bid.beamstudio.ai | cmauxbgww000582ry4644c2qr |
| `prod` | api.beamstudio.ai | clw5gbhuy0003u3rv4jzzoesh |

---

## Issue Statuses

Tasks are flagged as "issue" if status is:
- `FAILED` - Execution failed
Read the full skill on GitHub

Details

Skill name
beam-debug-issue-tasks
Path
skills/beam-debug-issue-tasks/SKILL.md
Repo updated
10 January 2026

FAQ

What does the Beam Debug Issue Tasks skill do?

Debug failed/issue tasks from Beam.ai using Langfuse traces. Load when user says "debug issue tasks", "check failed tasks", "why did task fail", "task errors", "debug agent", or needs to investigate task failures.

How do I install the Beam Debug Issue Tasks skill?

Claude Code plugin: /plugin marketplace add Freddy-CHEN-ux/00_claude_skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Beam Debug Issue Tasks popular?

It lives in Freddy-CHEN-ux/00_claude_skills, which has 8 GitHub stars and 3 forks.

Related skills

Browse the most popular Claude skills, all productivity & notes skills, or write your own with the skills generator.