AGENT SKILL

deepgram-migration-deep-dive

Deep dive into complex Deepgram migrations and provider transitions. Use when migrating from other transcription providers, planning large-scale migrations, or implementing phased rollout strategies. Trigger with phrases like "deepgram migration", "switch to deepgram", "migrate transcription", "deepgram from AWS", "deepgram from Google".

License 许可
MIT
最近更新
2026-05-26
Stars
★ 0
Forks
0

01 前言 Front Matter

name
deepgram-migration-deep-dive
author
Jeremy Longshore <jeremy@intentsolutions.io>
license
MIT
version
1.0.0
description
Deep dive into complex Deepgram migrations and provider transitions. Use when migrating from other transcription providers, planning large-scale migrations, or implementing phased rollout strategies. Trigger with phrases like "deepgram migration", "switch to deepgram", "migrate transcription", "deepgram from AWS", "deepgram from Google".
allowed-tools
Read, Write, Edit, Bash(kubectl:*), Bash(curl:*)
compatible-with
claude-code, codex, openclaw

02 资源文件 1

03 SKILL.md 正文

Deepgram Migration Deep Dive

Table of Contents

Overview

Comprehensive guide for migrating to Deepgram from other transcription providers (AWS Transcribe, Google Cloud STT, Azure Speech, OpenAI Whisper, Rev.ai, AssemblyAI) using an adapter pattern with parallel running and gradual traffic shifting.

Prerequisites

  • Current provider SDK and credentials
  • Deepgram API key and project configured
  • Test audio dataset for comparison
  • Monitoring infrastructure ready

Instructions

Step 1: Assessment

Audit current usage (hours/month, features), map features to Deepgram equivalents, and estimate costs.

Step 2: Implement Adapter Pattern

Create a TranscriptionAdapter interface with transcribe() and transcribeFile() methods, then implement both the legacy adapter and DeepgramAdapter.

Step 3: Build Migration Router

Create a MigrationRouter that routes traffic by percentage (0-100%) between providers, with optional parallel comparison mode.

Step 4: Parallel Running & Validation

Run both providers simultaneously, compare results using Jaccard similarity, and verify accuracy meets >= 90% threshold.

Step 5: Gradual Rollout

Shift traffic incrementally: 5% -> 25% (monitor 1 week) -> 50% (monitor 1 week) -> 100%.

Step 6: Cutover & Cleanup

Complete migration, decommission old provider, update documentation.

Output

  • TranscriptionAdapter interface and implementations
  • MigrationRouter with percentage-based routing
  • Validation script with similarity scoring
  • Feature mapping tables (AWS/Google -> Deepgram)
  • Rollback manager with checkpoint/restore

Error Handling

Issue Cause Resolution
Low similarity scores Feature mismatch Check feature mapping, adjust options
Deepgram latency higher Cold start or model Pre-warm connections, verify model selection
Missing features Incomplete mapping Use Deepgram keywords for custom vocabulary
Rollback needed Quality regression Call emergencyRollback() to set percentage to 0%

Examples

Feature Mapping (AWS -> Deepgram)

  • LanguageCode: en-US -> language: "en" (ISO 639-1)
  • ShowSpeakerLabels: true -> diarize: true
  • VocabularyName: custom -> keywords: ["term:1.5"]
  • ContentRedaction -> redact: ["pci", "ssn"]

Migration Checklist

Pre-migration, validation phase, rollout phase (5% -> 25% -> 50% -> 100%), post-migration cleanup.

See detailed implementation for advanced patterns.

Resources

04 同仓库更多 Skills

SamuelChien
SamuelChien/mega-skills-collection

zustand-store-ts

Create Zustand stores with TypeScript, subscribeWithSelector middleware, and proper state/action separation. Use when building React state management, creating global stores, or implementing reactive state patterns with Zustand.

★ 0
SamuelChien
SamuelChien/mega-skills-collection

zustand-store-creator

Zustand Store Creator - Auto-activating skill for Frontend Development. Triggers on: zustand store creator, zustand store creator Part of the Frontend Development skill category.

★ 0
SamuelChien
SamuelChien/mega-skills-collection

zero-trust-config-helper

Zero Trust Config Helper - Auto-activating skill for Security Advanced. Triggers on: zero trust config helper, zero trust config helper Part of the Security Advanced skill category.

★ 0
SamuelChien
SamuelChien/mega-skills-collection

zapier-integration-helper

Zapier Integration Helper - Auto-activating skill for Business Automation. Triggers on: zapier integration helper, zapier integration helper Part of the Business Automation skill category.

★ 0
SamuelChien
SamuelChien/mega-skills-collection

zai-cli

Execute z.AI CLI providing vision, search, reader, and GitHub exploration via CLI and MCP. Use when user needs image/video analysis, OCR, UI-to-code conversion, error diagnosis, real-time web search, web page to markdown extraction, or GitHub code exploration. Trigger with phrases like "analyze this image", "search the web for", "read this page", "explore this repo", or "use zai". Requires Z_AI_API_KEY.

★ 0
SamuelChien
SamuelChien/mega-skills-collection

yt-research

Research competitor YouTube channels, niches, and trending topics for your content strategy. Use this skill whenever the user says "research channels", "analyze competitors", "find trending topics", "niche analysis", "competitive research", "what are other creators doing", "scrape YouTube channels", or wants to understand the competitive landscape for a specific tool or topic area. Use when working with yt research. Trigger with 'yt', 'research'.

★ 0