Agent skill · software engineering · jeremylongshore
deepgram-local-dev-loop
Configure Deepgram local development workflow with testing and mocks.
Why this skill is useful
Adds specific commands and configurations for setting up a local development environment with Deepgram, including mock responses and testing patterns.
What it needs
Requires @deepgram/sdk, curl, dotenv, tsx, vitest 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 Local Dev Loop Examples Use a local or development workspace with a short licensed fixture, make one SDK/config change, run the focused unit test and a bounded integration test, then inspect redacted metrics. Commit only the reviewed change; never copy production recordings, transcripts, or API keys into a local test loop. Overview Set up a fast local development workflow for Deepgram: test fixtures with sample audio, mock responses for offline unit tests, Vitest integration tests against the real API, and a watch-mode transcription dev server. Prerequisites @deepgram/sdk installed, DEEPGRAMAPIKEY configured npm install -D vitest tsx dotenv for testing and dev server Optional: curl for downloading test fixtures Instructions Step 1: Project Structure Step 2: Download Test Fixtures Step 3: Environment Config Step 4: Mock Deepgram Responses Step 5: Unit Tests with Mocks Step 6: Integration Tests (Real API) Output Project structure with src, tests, fixtures directories Mock response objects matching real Deepgram API shape Unit tests with mocked SDK (no API calls) Integration tests against real API with timeout Watch mode for rapid iteration Error Handling Error Cause Solution ------- ------- ---------- Fixture 404 Deepgram moved sample URL Check latest URLs at developers.deepgram.com DEEPGRAMAPIKEY undefined in test .env.test not loaded Configure Vitest env or use dotenv/config Integration test timeout Network or API slow Increase timeout to 30000ms Mock shape mismatch API response changed Update mocks from real response capture Resources Vitest Documentation Deepgram Sample Audio SDK Testing Guide Next Steps Proceed to deepgram-sdk-patterns for production-ready code patterns.
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/deepgram-local-dev-loop