Agent skill · software engineering · jeremylongshore
deepgram-core-workflow-a
Implement production pre-recorded speech-to-text with Deepgram.
Why this skill is useful
Adds specific implementation details and API usage for Deepgram's transcription service that the AI wouldn't reliably generate on its own.
What it needs
Requires @deepgram/sdk, p-limit installed locally. Requires deepgram account access. About 4k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Deepgram Core Workflow A: Pre-recorded Transcription Examples Upload a short synthetic or licensed audio fixture to the development workflow, validate transcript format, timestamps, language/model choice, and error handling, then remove the artifact according to retention policy. Do not use customer recordings for a tutorial or log raw transcript text when a correlation ID and aggregate result suffice. Overview Production pre-recorded transcription service using Deepgram's REST API. Covers transcribeUrl and transcribeFile, speaker diarization, audio intelligence (summarization, topic detection, sentiment, intent), batch processing with concurrency control, and callback-based async transcription for large files. Prerequisites @deepgram/sdk installed, DEEPGRAMAPIKEY configured Audio files: WAV, MP3, FLAC, OGG, M4A, or WebM For batch: p-limit package (npm install p-limit) Instructions Step 1: Transcription Service Class Step 2: Extract Structured Results Step 3: Batch Processing Step 4: Async Callback Transcription (Large Files) Step 5: Keyword Boosting Output DeepgramTranscriber class with URL and file transcription Structured result extraction with word-level timing, speakers, and intelligence Batch processing with configurable concurrency via p-limit Async callback pattern for large files Keyword boosting for domain vocabulary Error Handling Error Cause Solution ------- ------- ---------- 400 Bad Request Invalid audio format Verify file header bytes (WAV: RIFF, MP3: 0xFFF3/0xFFFB) 413 Payload Too Large File exceeds limit Use callback URL for async processing Empty transcript No speech in audio Check audio volume, try alternatives: 3 for confidence 408 Timeout Long file, sync mode Switch to callback-based async Low confidence Background noise Preprocess: ffmpeg -i input.wav -af "highpass=f=200,lowpass=f=3000" clean.wav Resources Pre-recorded API Speaker Diarization Audio Intelligence Summarization Callback Feature Next Steps Proceed to deepgram-core-workflow-b for re …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/deepgram-core-workflow-a--3a0c4f