Skip to main content 首页 创作者 comeonoliver skillshub elevenlabs-debug-bundle
elevenlabs-debug-bundle Collect ElevenLabs debug evidence for support tickets and troubleshooting.
Use when encountering persistent issues, preparing support tickets,
or collecting diagnostic information for ElevenLabs problems.
Trigger: "elevenlabs debug", "elevenlabs support bundle",
"collect elevenlabs logs", "elevenlabs diagnostic", "elevenlabs support ticket".
跳到安装 Skills Marketplace 发现并探索由社区构建的 Agent Skills
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/ComeOnOliver/skillshub --skill elevenlabs-debug-bundle命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
下载 Zip 下载中... 同仓库更多 Skills Review product and feature risk before an AI coding agent starts implementation.
Use Xquik for X data and confirmation-gated X actions: tweet search, user lookup, follower export, media download, monitors, webhooks, MCP, and SDK workflows.
Canton Network open-source ecosystem guide covering DAML SDK, Canton runtime, and Splice applications. Use when working with Canton Network, DAML smart contracts, or building decentralized applications.
name elevenlabs-debug-bundle description Collect ElevenLabs debug evidence for support tickets and troubleshooting.
Use when encountering persistent issues, preparing support tickets,
or collecting diagnostic information for ElevenLabs problems.
Trigger: "elevenlabs debug", "elevenlabs support bundle",
"collect elevenlabs logs", "elevenlabs diagnostic", "elevenlabs support ticket".
allowed-tools Read, Bash(grep:*), Bash(curl:*), Bash(tar:*), Bash(node:*), Grep version 1.0.0 license MIT author Jeremy Longshore <jeremy@intentsolutions.io> tags ["saas","voice","ai","elevenlabs","debugging","support"] compatible-with claude-code
ElevenLabs Debug Bundle
Overview
Collect all diagnostic information needed for ElevenLabs support tickets. Gathers SDK version, API connectivity, quota status, voice inventory, and model availability while redacting all secrets.
Prerequisites
ElevenLabs SDK installed
API key configured (to test connectivity)
Access to application logs
Instructions
Step 1: Create Debug Bundle Script
#!/bin/bash
set -euo pipefail
BUNDLE_DIR="elevenlabs-debug-$(date +%Y%m%d-%H%M%S) "
mkdir -p "$BUNDLE_DIR "
echo "=== ElevenLabs Debug Bundle ===" > "$BUNDLE_DIR /summary.txt"
echo "Generated: $(date -u +%Y-%m-%dT%H:%M:%SZ) " >> "$BUNDLE_DIR /summary.txt"
echo "" >> "$BUNDLE_DIR /summary.txt"
echo "--- Runtime Environment ---" >> "$BUNDLE_DIR /summary.txt"
node --version 2>/dev/null >> "$BUNDLE_DIR /summary.txt" || echo "Node.js: not found" >> "$BUNDLE_DIR /summary.txt"
python3 --version 2>/dev/null >> "$BUNDLE_DIR /summary.txt" || echo "Python: not found" >> "$BUNDLE_DIR /summary.txt"
echo "OS: $(uname -s) >> $(uname -r)
"$BUNDLE_DIR /summary.txt"
echo
"API Key: ${ELEVENLABS_API_KEY:+SET (${#ELEVENLABS_API_KEY} chars)} "
"$BUNDLE_DIR /summary.txt"
echo
""
"$BUNDLE_DIR /summary.txt"
echo
"--- SDK Versions ---"
"$BUNDLE_DIR /summary.txt"
"$BUNDLE_DIR /summary.txt"
echo
"JS SDK: not installed"
"$BUNDLE_DIR /summary.txt"
"^(Name|Version)"
"$BUNDLE_DIR /summary.txt"
echo
"Python SDK: not installed"
"$BUNDLE_DIR /summary.txt"
echo
""
"$BUNDLE_DIR /summary.txt"
echo
"--- API Connectivity ---"
"$BUNDLE_DIR /summary.txt"
"%{http_code}"
"xi-api-key: ${ELEVENLABS_API_KEY:-missing} "
echo
"FAILED"
echo
"GET /v1/user: HTTP $HTTP_CODE "
"$BUNDLE_DIR /summary.txt"
head
echo
"DNS lookup failed"
echo
"DNS api.elevenlabs.io: $DNS_CHECK "
"$BUNDLE_DIR /summary.txt"
echo
"Verify return code: 0"
echo
"0"
echo
"TLS valid: $([ "$TLS_CHECK " = "1" ] && echo "yes" || echo "no" ) "
"$BUNDLE_DIR /summary.txt"
echo
""
"$BUNDLE_DIR /summary.txt"
if
"$HTTP_CODE "
"200"
then
echo
"--- Subscription ---"
"$BUNDLE_DIR /summary.txt"
"xi-api-key: ${ELEVENLABS_API_KEY} "
'{tier: .subscription.tier, character_count: .subscription.character_count, character_limit: .subscription.character_limit, next_reset: .subscription.next_character_count_reset_unix}'
"$BUNDLE_DIR /summary.txt"
echo
""
"$BUNDLE_DIR /summary.txt"
echo
"--- Voice Inventory ---"
"$BUNDLE_DIR /summary.txt"
"xi-api-key: ${ELEVENLABS_API_KEY} "
'[.voices[] | {name, voice_id, category}]'
"$BUNDLE_DIR /summary.txt"
echo
""
"$BUNDLE_DIR /summary.txt"
echo
"--- Available Models ---"
"$BUNDLE_DIR /summary.txt"
"xi-api-key: ${ELEVENLABS_API_KEY} "
'[.[] | {model_id, name, can_do_text_to_speech, can_do_voice_conversion}]'
"$BUNDLE_DIR /summary.txt"
fi
echo
"--- Config (redacted) ---"
"$BUNDLE_DIR /summary.txt"
if
env
then
's/=.*/=***REDACTED***/'
env
"$BUNDLE_DIR /config-redacted.txt"
fi
echo
"--- Recent Errors ---"
"$BUNDLE_DIR /summary.txt"
"elevenlabs\|ElevenLabs\|xi-api-key"
log
's/sk_[a-zA-Z0-9]*/sk_***REDACTED***/g'
tail
"$BUNDLE_DIR /errors.txt"
echo
"No log files found"
"$BUNDLE_DIR /errors.txt"
"$BUNDLE_DIR .tar.gz"
"$BUNDLE_DIR "
rm
"$BUNDLE_DIR "
echo
""
echo
"Bundle created: $BUNDLE_DIR .tar.gz"
echo
"Review for sensitive data before sharing with support."
Step 2: Programmatic Debug Collection
import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js" ;
interface DebugReport {
timestamp : string ;
sdk : { package : string ; version : string };
connectivity : { status : number ; latencyMs : number };
subscription : { tier : string ; used : number ; limit : number ; resetAt : string } | null ;
voices : { total : number ; cloned : number ; premade : number } | null ;
models : string [] | null ;
errors : string [];
}
export async function collectDebugReport (Promise <DebugReport > {
const client = new ElevenLabsClient ();
const errors : string [] = [];
const report : DebugReport = {
timestamp : new Date ().toISOString (),
sdk : { package : "@elevenlabs/elevenlabs-js" , version : "unknown" },
connectivity : { status : 0 , latencyMs : 0 },
subscription : null ,
voices : null ,
models : null ,
errors,
};
const start = Date .now ();
try {
const user = await client.user .get ();
report.connectivity = { status : 200 , latencyMs : Date .now () - start };
report.subscription = {
tier : user.subscription .tier ,
used : user.subscription .character_count ,
limit : user.subscription .character_limit ,
resetAt : new Date (user.subscription .next_character_count_reset_unix * 1000 ).toISOString (),
};
} catch (err : any ) {
report.connectivity = { status : err.statusCode || 0 , latencyMs : Date .now () - start };
errors.push (`Auth: ${err.message} ` );
}
try {
const { voices } = await client.voices .getAll ();
report.voices = {
total : voices.length ,
cloned : voices.filter (v =>category === "cloned" ).length ,
premade : voices.filter (v =>category === "premade" ).length ,
};
} catch (err : any ) {
errors.push (`Voices: ${err.message} ` );
}
try {
const models = await client.models .getAll ();
report.models = models.map (m =>model_id );
} catch (err : any ) {
errors.push (`Models: ${err.message} ` );
}
return report;
}
const report = await collectDebugReport ();
console .log (JSON .stringify (report, null , 2 ));
Step 3: Submit to Support
Run: bash elevenlabs-debug-bundle.sh (or the programmatic version)
Review the output for any accidentally included secrets
Open a ticket at https://help.elevenlabs.io
Attach the bundle and describe the issue with:
What you expected to happen
What actually happened
Steps to reproduce
Request IDs from error responses (if available)
Output
elevenlabs-debug-YYYYMMDD-HHMMSS.tar.gz archive containing:
summary.txt — Environment, SDK, connectivity, quota, voices, modelsconfig-redacted.txt — Configuration with secrets maskederrors.txt — Recent error logs with API keys redacted
Sensitive Data Handling Always redacted automatically:
API keys (replaced with ***REDACTED***)
Webhook secrets
Any value after = in .env files
Error messages and stack traces
SDK/runtime versions
Voice IDs and model IDs
HTTP status codes and latency
Error Handling Issue Cause Solution jq: command not foundjq not installed apt install jq or brew install jqHTTP 0 / curl fails Network issue Check DNS and firewall HTTP 401 Bad API key Regenerate key at elevenlabs.io Empty voice list No voices on account Normal for new free accounts
Resources
Next Steps For rate limit issues, see elevenlabs-rate-limits. For common errors, see elevenlabs-common-errors.
