New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Deepgram Common Errors

by jeremylongshore in jeremylongshore/tons-of-skills-marketplace

Diagnose and fix common Deepgram errors and issues. An agent skill from jeremylongshore/tons-of-skills-marketplace.

MITAuto-check passedMedia & Creative

Install Deepgram Common Errors

skills CLI
$ npx skills add jeremylongshore/tons-of-skills-marketplace --skill deepgram-common-errors -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install jeremylongshore/tons-of-skills-marketplace deepgram-common-errors --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/jeremylongshore/tons-of-skills-marketplace.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/.curated/deepgram-common-errors .claude/skills/deepgram-common-errors && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
deepgram-common-errors
GitHub stars
2.8k
Token cost
~1.9k tokens
SKILL.md length
382 words
Files
2 (incl. references)
Skills in repo
3,342
Repo updated
First seen
Licence
MIT

At a glance

Diagnose and fix common Deepgram errors and issues. An agent skill from jeremylongshore/tons-of-skills-marketplace.

  • Works in 6 steps: Quick Diagnostic → HTTP Error Reference → WebSocket Errors → …
  • Troubleshooting Deepgram API errors
  • SKILL.md covers Examples, Overview, Prerequisites and Instructions, plus 3 more sections
  • Calls curl, ffmpeg and ffprobe; reaches api.deepgram.com and static.deepgram.com; needs DEEPGRAM_API_KEY

What it does

Deepgram Common Errors is an agent skill from jeremylongshore/tons-of-skills-marketplace. Diagnose and fix common Deepgram errors and issues. Use when troubleshooting Deepgram API errors, debugging transcription failures, or resolving integration issues. Trigger: "deepgram error", "deepgram not working", "fix deepgram", "deepgram troubleshoot", "transcription failed", "deepgram 401".

Its SKILL.md is about 1.9k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/implementation.md`). Compatibility notes: Designed for Claude Code

It sits in Media & Creative, covering Transcription. It works with Deepgram. The repository describes itself as: Model-agnostic agent-skills platform with a harness-free canonical layer, verified adapters, and the ccpi package manager. Explore at tonsofskills.com. The licence is MIT.

When your agent uses it

  • Troubleshooting Deepgram API errors
  • Debugging transcription failures
  • Resolving integration issues

Example prompts

  • “deepgram error”
  • “deepgram not working”
  • “fix deepgram”
  • “/deepgram-common-errors”

Requirements

  • A credential in DEEPGRAM_API_KEY
  • Compatibility (from SKILL.md): Designed for Claude Code
  • Pre-approved tools (allowed-tools): Read, Grep, Bash(curl:*)

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Quick Diagnostic
  2. HTTP Error Reference
  3. WebSocket Errors
  4. Transcription Quality Issues
  5. SDK-Specific Errors
  6. Retry Pattern for Transient Errors

What it can do on your machine

Read from SKILL.md and the folder at commit 80f86df. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Grep
    • Bash(curl:*)

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • curl
    • ffmpeg
    • ffprobe

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • api.deepgram.com
    • static.deepgram.com

    Also links to:

    • developers.deepgram.com
    • status.deepgram.com
    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • DEEPGRAM_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    Designed for Claude Code

    From compatibility in the SKILL.md frontmatter.

Context cost

Deepgram Common Errors loads about 1.9k tokens when it runs, and up to ~2.8k if it reads all its reference files. Until then it costs about 80 tokens; SKILL.md has 382 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~80
When it runs · the whole SKILL.md, loaded when a task matches
~1.9k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from jeremylongshore/tons-of-skills-marketplace at commit 80f86df, republished under its MIT licence (© jeremylongshore). 382 words, ~1,864 tokens.

Download SKILL.mdSave it as .claude/skills/deepgram-common-errors/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
deepgram-common-errors
description
Diagnose and fix common Deepgram errors and issues. Use when troubleshooting Deepgram API errors, debugging transcription failures, or resolving integration issues. Trigger: "deepgram error", "deepgram not working", "fix deepgram", "deepgram troubleshoot", "transcription failed", "deepgram 401".
allowed-tools
Read, Grep, Bash(curl:*)
compatibility
Designed for Claude Code
version
1.13.0
license
MIT
author
Jeremy Longshore <jeremy@intentsolutions.io>
tags
saas, deepgram, api, debugging, transcription

Deepgram Common Errors

Examples

For a failed transcription request, record its opaque correlation ID, environment, model, status class, and redacted timing. Check media format, credentials, timeout, and rate-limit state with a non-sensitive fixture; if the condition remains, escalate with the minimal redacted bundle rather than attaching customer audio or transcript text.

Overview

Comprehensive error reference for Deepgram API integration. Covers HTTP error codes, WebSocket errors, transcription quality issues, SDK-specific problems, and audio format debugging with real diagnostic commands.

Prerequisites

  • Deepgram API key configured
  • curl available for API testing
  • Access to application logs

Instructions

Step 1: Quick Diagnostic
bash
# Test API key validity
curl -s -w "\nHTTP %{http_code}\n" \
  'https://api.deepgram.com/v1/projects' \
  -H "Authorization: Token $DEEPGRAM_API_KEY"

# Test transcription endpoint
curl -s -w "\nHTTP %{http_code}\n" \
  -X POST 'https://api.deepgram.com/v1/listen?model=nova-3&smart_format=true' \
  -H "Authorization: Token $DEEPGRAM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://static.deepgram.com/examples/Bueller-Life-moves-702702706.wav"}'
Step 2: HTTP Error Reference
CodeErrorCauseSolution
400Bad RequestInvalid audio format, bad paramsCheck audio headers, validate query params
401UnauthorizedInvalid/expired API keyRegenerate in Console > API Keys
403ForbiddenKey lacks scopeCreate key with listen scope for STT
404Not FoundWrong endpoint URLUse api.deepgram.com/v1/listen
408TimeoutAudio too long for syncUse callback param for async
413Payload Too LargeFile exceeds 2GBSplit with ffmpeg -f segment -segment_time 3600
429Too Many RequestsConcurrency limit hitImplement backoff, check plan limits
500Internal ErrorDeepgram server errorRetry with backoff, check status.deepgram.com
502Bad GatewayUpstream failureRetry after 5-10 seconds
503Service UnavailableMaintenance/overloadCheck status.deepgram.com, retry later
Step 3: WebSocket Errors
typescript
import { LiveTranscriptionEvents } from '@deepgram/sdk';

connection.on(LiveTranscriptionEvents.Error, (error) => {
  console.error('WebSocket error:', {
    message: error.message,
    type: error.type,
  });
});

// Common WebSocket issues:
// 1. Connection closes after ~10s of silence
//    Fix: Send keepAlive() every 8 seconds
connection.keepAlive();

// 2. "Could not process audio" errors
//    Fix: Verify encoding matches what you send
//    Must match: encoding, sample_rate, channels in listen.live() options

// 3. Connection refused / ECONNREFUSED
//    Fix: Check firewall allows wss://api.deepgram.com:443

// 4. Immediate disconnect with 1008 (Policy Violation)
//    Fix: API key invalid or lacks live streaming scope
Show full SKILL.md (162 more words)Show less
Step 4: Transcription Quality Issues
bash
# Check audio properties with ffprobe
ffprobe -v quiet -print_format json -show_format -show_streams input.wav

# Optimal audio for Deepgram:
# - Sample rate: 8000-48000 Hz (16000 recommended)
# - Channels: 1 (mono) or 2 (stereo for multichannel)
# - Bit depth: 16-bit
# - Format: WAV, MP3, FLAC, OGG, M4A, WebM

# Fix audio quality
ffmpeg -i noisy.wav \
  -af "highpass=f=200,lowpass=f=3000,volume=2" \
  -ar 16000 -ac 1 -acodec pcm_s16le \
  clean.wav
Quality IssueLikely CauseFix
Empty transcriptNo speech / too quietBoost volume: -af "volume=3"
Garbled outputWrong encoding parameterMatch encoding to actual audio format
Missing wordsBackground noiseApply noise filter before transcription
Wrong languageLanguage not specifiedSet language: 'en' (or correct ISO code)
Low confidencePoor audio qualityPreprocess to 16kHz mono, noise-reduce
Speaker mismatchDiarization offEnable diarize: true
Step 5: SDK-Specific Errors
typescript
// TypeError: createClient is not a function
// You have SDK v5 installed. Use:
import { DeepgramClient } from '@deepgram/sdk';
const dg = new DeepgramClient({ apiKey: process.env.DEEPGRAM_API_KEY });

// TypeError: Cannot read properties of undefined (reading 'prerecorded')
// v5 uses versioned namespaces:
await dg.listen.v1.media.transcribeUrl(source, options);

// "error": { "message": "..." } in result
// Always check the error field:
const { result, error } = await dg.listen.prerecorded.transcribeUrl(source, opts);
if (error) {
  console.error('Deepgram error:', error.message);
  // Don't try to access result — it may be undefined
}

// Python: deepgram.errors.DeepgramApiError
// Catch with try/except:
try:
    response = client.listen.rest.v("1").transcribe_url(source, options)
except Exception as e:
    print(f"API error: {e}")
Step 6: Retry Pattern for Transient Errors
typescript
async function transcribeWithRetry(
  client: any,
  source: any,
  options: any,
  maxRetries = 3
) {
  for (let attempt = 0; attempt <= maxRetries; attempt++) {
    try {
      const { result, error } = await client.listen.prerecorded.transcribeUrl(
        source, options
      );
      if (error) {
        // 429 and 5xx are retryable
        if (error.status === 429 || error.status >= 500) {
          throw new Error(`Retryable: ${error.status}`);
        }
        throw new Error(`Non-retryable: ${error.message}`);
      }
      return result;
    } catch (err: any) {
      if (attempt === maxRetries || !err.message.startsWith('Retryable')) {
        throw err;
      }
      const delay = Math.min(1000 * Math.pow(2, attempt) + Math.random() * 1000, 30000);
      console.log(`Retry ${attempt + 1}/${maxRetries} in ${Math.round(delay)}ms`);
      await new Promise(resolve => setTimeout(resolve, delay));
    }
  }
}

Output

  • API diagnostic curl commands
  • HTTP error reference with solutions
  • WebSocket error handling patterns
  • Audio quality debugging with ffprobe/ffmpeg
  • SDK version-specific error fixes
  • Retry pattern for transient failures

Error Handling

ErrorCauseSolution
ECONNRESETNetwork interruptionImplement retry with backoff
ETIMEDOUTSlow network or large fileIncrease timeout, use callback
ERR_INVALID_ARG_TYPEPassing string instead of Buffer to transcribeFileUse readFileSync(path)
CORS error (browser)API called from client-sideProxy through your server

Resources

© jeremylongshore, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (references) in skills/.curated/deepgram-common-errors of jeremylongshore/tons-of-skills-marketplace.

  • SKILL.md
  • references/implementation.md

Open the folder on GitHubat commit 80f86df

Compare with similar skills

Deepgram Common Errors next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Deepgram Common Errors compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Deepgram Common Errors this skilljeremylongshore/tons-of-skills-marketplace2.8k—~1.9kAutomated safety check: PassMIT
DeepgramAnil-matcha/awesome-muse-connectors1.3k—~857Automated safety check: PassMIT
9Router Speech-to-Textdecolua/9router30k—~914Automated safety check: PassMIT
Deepgram JS Audio Intelligencedeepgram/deepgram-js-sdk276—~1.5kAutomated safety check: PassMIT
Deepgram JS Speech To Textdeepgram/deepgram-js-sdk276—~1.8kAutomated safety check: PassMIT
Keirouter Sttmydisha/keirouter147—~680Automated safety check: PassMIT

Similar skills

  • Deepgram

    Anil-matcha/awesome-muse-connectors

    Deepgram speech AI: transcribe audio to text and synthesize speech (TTS).

    1.3k GitHub stars~857 tokensUpdated 3 days ago
    Media & CreativeAuto-check passed

  • 9Router Speech-to-Text

    decolua/9router

    Transcribes audio files into text or subtitles through 9Router's Whisper-compatible endpoint, using models from OpenAI, Groq, Gemini, Deepgram and others.

    30k GitHub stars~914 tokensUpdated today
    Media & CreativeAuto-check passed

  • Deepgram JS Audio Intelligence

    deepgram/deepgram-js-sdk

    A skill your agent uses when writing or reviewing JavaScript/TypeScript in this repo that calls Deepgram audio analytics overlays on /v1/listen - summarize, topics, intents, sentiment, diarize…

    276 GitHub stars~1.5k tokensUpdated today
    Media & CreativeAuto-check passed

  • Deepgram JS Speech To Text

    deepgram/deepgram-js-sdk

    A skill your agent uses when writing or reviewing JavaScript/TypeScript in this repo that calls Deepgram Speech-to-Text v1 (/v1/listen) for prerecorded or live audio transcription.

    276 GitHub stars~1.8k tokensUpdated today
    Media & CreativeAuto-check passed

  • Keirouter Stt

    mydisha/keirouter

    Speech-to-text via KeiRouter /v1/audio/transcriptions using OpenAI Whisper / Groq / Gemini / Deepgram / AssemblyAI models.

    147 GitHub stars~680 tokensUpdated 28 days ago
    Media & CreativeAuto-check passed

  • Deepgram Audio Intelligence for Python

    deepgram/deepgram-python-sdk

    Shows how to add Deepgram analytics such as diarization, summaries, sentiment, topics, redaction and language detection to speech transcription in Python.

    469 GitHub stars~2.3k tokensUpdated today
    AI & LLM EngineeringAuto-check passed

More from jeremylongshore/tons-of-skills-marketplace

All 3,342 skills in this repo

  • Performing Security Code Review

    jeremylongshore/tons-of-skills-marketplace

    Execute this skill enables AI assistant to conduct a security-focused code review using the security-agent plugin.

    2.8k GitHub starsUsed in 2 repos~1.3k tokens
    Auto-check: notes

  • Adapting Transfer Learning Models

    jeremylongshore/tons-of-skills-marketplace

    Build this skill automates the adaptation of pre-trained machine learning models using transfer learning techniques.

    2.8k GitHub stars~1.1k tokensUpdated today
    Auto-check passed

  • Agent Context Loader

    jeremylongshore/tons-of-skills-marketplace

    Execute proactive auto-loading: automatically detects and loads agents.md files.

    2.8k GitHub stars~1.1k tokensUpdated today
    Auto-check passed

  • Aggregating Performance Metrics

    jeremylongshore/tons-of-skills-marketplace

    Aggregate and centralize performance metrics from applications, systems, databases, caches, and services.

    2.8k GitHub stars~1.2k tokensUpdated today
    Auto-check passed

  • Analyzing Capacity Planning

    jeremylongshore/tons-of-skills-marketplace

    Execute this skill enables AI assistant to analyze capacity requirements and plan for future growth.

    2.8k GitHub stars~947 tokensUpdated today
    Auto-check passed

  • Analyzing Database Indexes

    jeremylongshore/tons-of-skills-marketplace

    Process use when you need to work with database indexing. An agent skill from jeremylongshore/tons-of-skills-marketplace.

    2.8k GitHub stars~2k tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Deepgram Common Errors

What does Deepgram Common Errors do?

Diagnose and fix common Deepgram errors and issues. An agent skill from jeremylongshore/tons-of-skills-marketplace. Deepgram Common Errors is an agent skill from jeremylongshore/tons-of-skills-marketplace. Diagnose and fix common Deepgram errors and issues.

When should I use Deepgram Common Errors?

Deepgram Common Errors fits situations like: troubleshooting Deepgram API errors; debugging transcription failures; resolving integration issues.

How do I install Deepgram Common Errors in Claude Code?

Run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill deepgram-common-errors -a claude-code`. Or copy the skill folder (skills/.curated/deepgram-common-errors in jeremylongshore/tons-of-skills-marketplace) into .claude/skills/deepgram-common-errors in your project. Claude Code loads it when a task matches its description.

How do I install Deepgram Common Errors in Codex?

Run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill deepgram-common-errors -a codex`. Or copy the skill folder (skills/.curated/deepgram-common-errors in jeremylongshore/tons-of-skills-marketplace) into .agents/skills/deepgram-common-errors in your project. Codex loads it when a task matches its description.

Can I use Deepgram Common Errors in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill deepgram-common-errors -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/deepgram-common-errors, .gemini/skills/deepgram-common-errors, .github/skills/deepgram-common-errors and .opencode/skills/deepgram-common-errors in your project.

What does Deepgram Common Errors need to run?

Going by SKILL.md and its folder, Deepgram Common Errors needs the command-line tools its instructions call (curl, ffmpeg and ffprobe) and credentials named DEEPGRAM_API_KEY. Our summary lists: A credential in DEEPGRAM_API_KEY. Its frontmatter pre-approves these tools: Read, Grep, Bash(curl:*). Compatibility (from SKILL.md): Designed for Claude Code.

Does Deepgram Common Errors access the network?

SKILL.md names 5 domains. In commands or code: api.deepgram.com and static.deepgram.com; the agent is likely to contact these when it follows the instructions. As links in the text: developers.deepgram.com, status.deepgram.com and github.com. This is read from the text; nothing was executed.

Is Deepgram Common Errors safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Deepgram Common Errors use?

Deepgram Common Errors is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Deepgram Common Errors use?

About 1.9k tokens (SKILL.md is roughly 7.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 969 tokens, read only when the agent opens those files.

What are the alternatives to Deepgram Common Errors?

Skills that share tags, products or a category with Deepgram Common Errors: Deepgram (Anil-matcha/awesome-muse-connectors, 1.3k stars), 9Router Speech-to-Text (decolua/9router, 30k stars), Deepgram JS Audio Intelligence (deepgram/deepgram-js-sdk, 276 stars) and Deepgram JS Speech To Text (deepgram/deepgram-js-sdk, 276 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Deepgram Common Errors?

jeremylongshore (a GitHub user) maintains it in jeremylongshore/tons-of-skills-marketplace, which has 2,825 GitHub stars. The repository holds 3,342 skills in this directory. The repository was last updated on October 9, 2026.

Source: jeremylongshore/tons-of-skills-marketplace on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.