Agent skill · software engineering · jeremylongshore
deepgram-upgrade-migration
Plan and execute Deepgram SDK upgrades and model migrations.
Why this skill is useful
Adds detailed migration scripts and breaking change maps for Deepgram SDK upgrades that the AI wouldn't reliably generate on its own.
What it needs
Requires npm 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 Upgrade Migration Prerequisites Current/target SDK or API versions, compatibility matrix, approved fixtures, quality/latency thresholds, and rollback owner. Separate staging credentials plus a data-retention and consent review for any migration/reprocessing action. Examples Upgrade the SDK in staging, run mock/unit tests and a small licensed-fixture comparison against the prior version, and compare aggregate output/latency/error metrics. Promote through an approved canary only after acceptance passes; revert to the prior lockfile/configuration on regression and do not reprocess production recordings to validate the upgrade. Current State !npm list @deepgram/sdk 2>/dev/null grep deepgram echo 'SDK not installed' Overview Guide for Deepgram SDK version upgrades (v3 -> v4 -> v5) and model migrations (Nova-2 -> Nova-3). Includes breaking change maps, side-by-side API comparison, A/B testing scripts, automated validation, and rollback procedures. SDK Version History Version Client Init STT API Live API TTS API Status --------- ------------ --------- ---------- --------- -------- v3.x createClient(key) listen.prerecorded.transcribeUrl() listen.live() speak.request() Stable v4.x createClient(key) listen.prerecorded.transcribeUrl() listen.live() speak.request() Stable v5.x new DeepgramClient({apiKey}) listen.v1.media.transcribeUrl() listen.v1.connect() speak.v1.audio.generate() Beta Instructions Step 1: Identify Current Version and Breaking Changes Step 2: v3/v4 to v5 Migration Map Step 3: Model Migration (Nova-2 -> Nova-3) Step 4: A/B Test Models Step 5: Automated Validation Suite Step 6: Rollback Procedure Output SDK version migration map (v3/v4 -> v5) Model migration path (Nova-2 -> Nova-3) A/B testing script with similarity scoring Automated validation test suite Rollback procedure Error Handling Issue Cause Solution ------- ------- ---------- createClient is not a function v5 installed Use new DeepgramClient() listen.prerecorded is undefined v5 namespace chang …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/deepgram-upgrade-migration--dd37a0