Agent skill

Deepgram Prod Checklist

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

Execute Deepgram production deployment checklist. An agent skill from jeremylongshore/tons-of-skills-marketplace.

MITAuto-check passedDevOps & Cloud

Install Deepgram Prod Checklist

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

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

GitHub CLI
$ gh skill install jeremylongshore/tons-of-skills-marketplace deepgram-prod-checklist --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-prod-checklist .claude/skills/deepgram-prod-checklist && 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-prod-checklist
GitHub stars
2.8k
Token cost
~2.3k tokens
SKILL.md length
415 words
Files
2 (incl. references)
Skills in repo
3,342
Repo updated
First seen
Licence
MIT

At a glance

Execute Deepgram production deployment checklist. An agent skill from jeremylongshore/tons-of-skills-marketplace.

  • Works in 6 steps: Production Singleton Client → Health Check Endpoint → Prometheus Metrics → …
  • Preparing for production launch
  • SKILL.md covers Prerequisites, Examples, Overview and Production Readiness Matrix, plus 4 more sections
  • Needs DEEPGRAM_API_KEY

What it does

Deepgram Prod Checklist is an agent skill from jeremylongshore/tons-of-skills-marketplace. Execute Deepgram production deployment checklist. Use when preparing for production launch, auditing production readiness, or verifying deployment configurations. Trigger: "deepgram production", "deploy deepgram", "deepgram prod checklist", "deepgram go-live", "production ready deepgram".

Its SKILL.md is about 2.3k 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 DevOps & Cloud, covering Deployment and Monitoring and alerting. It works with Deepgram and Prometheus. 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

  • Preparing for production launch
  • Auditing production readiness
  • Verifying deployment configurations

Example prompts

  • “deepgram production”
  • “deploy deepgram”
  • “deepgram prod checklist”
  • “/deepgram-prod-checklist”

Requirements

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

Workflow steps

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

  1. Production Singleton Client
  2. Health Check Endpoint
  3. Prometheus Metrics
  4. Alert Rules (Prometheus/AlertManager)
  5. Error Handling Wrapper
  6. Go-Live Timeline

What it can do on your machine

Read from SKILL.md and the folder at commit cfae287. 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
    • Write
    • Edit
    • Grep
    • Bash(curl:*)

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are typescript and yaml).

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

  • Network

    Links to these hosts (documentation or services it may open):

    • prometheus.io

    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 Prod Checklist loads about 2.3k tokens when it runs, and up to ~3.6k if it reads all its reference files. Until then it costs about 78 tokens; SKILL.md has 415 words of instructions outside code blocks.

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

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 cfae287, republished under its MIT licence (© jeremylongshore). 415 words, ~2,272 tokens.

Download SKILL.mdSave it as .claude/skills/deepgram-prod-checklist/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
deepgram-prod-checklist
description
Execute Deepgram production deployment checklist. Use when preparing for production launch, auditing production readiness, or verifying deployment configurations. Trigger: "deepgram production", "deploy deepgram", "deepgram prod checklist", "deepgram go-live", "production ready deepgram".
allowed-tools
Read, Write, Edit, Grep, Bash(curl:*)
compatibility
Designed for Claude Code
version
1.13.0
license
MIT
author
Jeremy Longshore <jeremy@intentsolutions.io>
tags
saas, deepgram, deployment, production

Deepgram Production Checklist

Prerequisites

  • A named service/data owner, approved model/provider/data-routing decision, and production rollback plan.
  • Passing staging evidence for credentials, audio retention/consent, observability, rate limits, quality, and incident escalation.

Examples

Run the final production gate with a non-sensitive canary, verify alert routing and the redacted request receipt, then observe against the stated quality/latency/error threshold. If any gate fails, halt rollout and restore the previous approved configuration rather than extending the canary or disabling controls.

Overview

Comprehensive go-live checklist for Deepgram integrations. Covers singleton client, health checks, Prometheus metrics, alert rules, error handling, and a phased go-live timeline.

Production Readiness Matrix

CategoryItemStatus
AuthProduction API key with scoped permissions[ ]
AuthKey stored in secret manager (not env file)[ ]
AuthKey rotation schedule (90-day) configured[ ]
AuthFallback key provisioned and tested[ ]
ResilienceRetry with exponential backoff on 429/5xx[ ]
ResilienceCircuit breaker for cascade failure prevention[ ]
ResilienceRequest timeout set (30s pre-recorded, 10s TTS)[ ]
ResilienceGraceful degradation when API unavailable[ ]
PerformanceSingleton client (not creating per-request)[ ]
PerformanceConcurrency limited (50-80% of plan limit)[ ]
PerformanceAudio preprocessed (16kHz mono for best results)[ ]
PerformanceLarge files use callback URL (async)[ ]
MonitoringHealth check endpoint testing Deepgram API[ ]
MonitoringPrometheus metrics: latency, error rate, usage[ ]
MonitoringAlerts: error rate >5%, latency >10s, circuit open[ ]
SecurityPII redaction enabled if handling sensitive audio[ ]
SecurityAudio URLs validated (HTTPS, no private IPs)[ ]
SecurityAudit logging on all operations[ ]

Instructions

Step 1: Production Singleton Client
typescript
import { createClient, DeepgramClient } from '@deepgram/sdk';

class ProductionDeepgram {
  private static client: DeepgramClient | null = null;

  static getClient(): DeepgramClient {
    if (!this.client) {
      const key = process.env.DEEPGRAM_API_KEY;
      if (!key) throw new Error('DEEPGRAM_API_KEY required for production');
      this.client = createClient(key);
    }
    return this.client;
  }

  // Force re-init (for key rotation)
  static reset() { this.client = null; }
}
Step 2: Health Check Endpoint
typescript
import express from 'express';
import { createClient } from '@deepgram/sdk';

const app = express();
const deepgram = createClient(process.env.DEEPGRAM_API_KEY!);

app.get('/health', async (req, res) => {
  const start = Date.now();
  try {
    // Test API connectivity by listing projects
    const { error } = await deepgram.manage.getProjects();
    const latency = Date.now() - start;

    if (error) {
      return res.status(503).json({
        status: 'unhealthy',
        deepgram: 'error',
        error: error.message,
        latency_ms: latency,
      });
    }

    res.json({
      status: 'healthy',
      deepgram: 'connected',
      latency_ms: latency,
      timestamp: new Date().toISOString(),
    });
  } catch (err: any) {
    res.status(503).json({
      status: 'unhealthy',
      deepgram: 'unreachable',
      error: err.message,
      latency_ms: Date.now() - start,
    });
  }
});
Step 3: Prometheus Metrics
typescript
import { Counter, Histogram, Gauge, Registry } from 'prom-client';

const registry = new Registry();

const transcriptionRequests = new Counter({
  name: 'deepgram_requests_total',
  help: 'Total Deepgram API requests',
  labelNames: ['method', 'model', 'status'],
  registers: [registry],
});

const transcriptionLatency = new Histogram({
  name: 'deepgram_latency_seconds',
  help: 'Deepgram API request latency',
  labelNames: ['method', 'model'],
  buckets: [0.5, 1, 2, 5, 10, 30],
  registers: [registry],
});

const audioProcessed = new Counter({
  name: 'deepgram_audio_seconds_total',
  help: 'Total audio seconds processed',
  labelNames: ['model'],
  registers: [registry],
});

const activeConnections = new Gauge({
  name: 'deepgram_active_connections',
  help: 'Active WebSocket connections',
  registers: [registry],
});

// Instrumented transcription
async function instrumentedTranscribe(url: string, model = 'nova-3') {
  const timer = transcriptionLatency.startTimer({ method: 'prerecorded', model });
  try {
    const { result, error } = await deepgram.listen.prerecorded.transcribeUrl(
      { url }, { model, smart_format: true }
    );
    timer();
    transcriptionRequests.inc({ method: 'prerecorded', model, status: error ? 'error' : 'ok' });
    if (result?.metadata?.duration) {
      audioProcessed.inc({ model }, result.metadata.duration);
    }
    if (error) throw error;
    return result;
  } catch (err) {
    timer();
    transcriptionRequests.inc({ method: 'prerecorded', model, status: 'error' });
    throw err;
  }
}

// Expose metrics endpoint
app.get('/metrics', async (req, res) => {
  res.set('Content-Type', registry.contentType);
  res.send(await registry.metrics());
});
Show full SKILL.md (168 more words)Show less
Step 4: Alert Rules (Prometheus/AlertManager)
yaml
groups:
  - name: deepgram
    rules:
      - alert: DeepgramHighErrorRate
        expr: rate(deepgram_requests_total{status="error"}[5m]) / rate(deepgram_requests_total[5m]) > 0.05
        for: 5m
        labels:
          severity: critical
        annotations:
          summary: "Deepgram error rate > 5%"

      - alert: DeepgramHighLatency
        expr: histogram_quantile(0.95, rate(deepgram_latency_seconds_bucket[5m])) > 10
        for: 5m
        labels:
          severity: warning
        annotations:
          summary: "Deepgram P95 latency > 10s"

      - alert: DeepgramHealthCheckFailed
        expr: up{job="deepgram-service"} == 0
        for: 2m
        labels:
          severity: critical
        annotations:
          summary: "Deepgram health check failed for 2+ minutes"
Step 5: Error Handling Wrapper
typescript
async function safeTranscribe(url: string, options: Record<string, any> = {}) {
  const timeout = options.timeout ?? 30000;

  const controller = new AbortController();
  const timeoutId = setTimeout(() => controller.abort(), timeout);

  try {
    const result = await Promise.race([
      instrumentedTranscribe(url, options.model ?? 'nova-3'),
      new Promise((_, reject) =>
        setTimeout(() => reject(new Error('Transcription timeout')), timeout)
      ),
    ]);
    clearTimeout(timeoutId);
    return result;
  } catch (err: any) {
    clearTimeout(timeoutId);
    // Log structured error
    console.error(JSON.stringify({
      level: 'error',
      service: 'deepgram',
      message: err.message,
      url: url.substring(0, 100),
      timestamp: new Date().toISOString(),
    }));
    throw err;
  }
}
Step 6: Go-Live Timeline
PhaseWhenActions
D-71 week beforeLoad test at 2x expected volume, security review
D-33 days beforeSmoke test with production key, verify all alerts fire
D-1Day beforeConfirm on-call rotation, validate dashboards
D-0LaunchShadow mode (10% traffic), monitoring open
D+1Day afterReview error rate, latency, verify no anomalies
D+71 week afterFull traffic, tune alert thresholds based on baselines

Output

  • Singleton client with reset capability
  • Health check endpoint with latency reporting
  • Prometheus metrics (requests, latency, audio, connections)
  • AlertManager rules for error rate, latency, availability
  • Timeout-safe transcription wrapper
  • Phased go-live timeline

Error Handling

IssueCauseSolution
Health check 503API key expiredRotate key, check secret manager
Metrics not scrapedWrong port/pathVerify Prometheus target config
Alert stormsThresholds too tightAdd for: duration, tune values
Timeout on large filesSync mode too slowSwitch to callback URL pattern

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-prod-checklist of jeremylongshore/tons-of-skills-marketplace.

  • SKILL.md
  • references/implementation.md

Open the folder on GitHubat commit cfae287

Compare with similar skills

Deepgram Prod Checklist 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 Prod Checklist compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Deepgram Prod Checklist this skilljeremylongshore/tons-of-skills-marketplace2.8k—~2.3kAutomated safety check: PassMIT
Dashboard Previewm4r1k/Eneru149—~1.4kAutomated safety check: PassMIT
Alicloud Acs Agent Sandboxcinience/alicloud-skills397—~2.7kAutomated safety check: PassMIT
Aqua Metricsoracle/accelerated-data-science125—~1.5kAutomated safety check: PassUPL-1.0
Analyzing Experiment Precompute CanaryPostHog/posthog40k—~3.5kAutomated safety check: PassCustom licence
Doca Collectx DeploymentNVIDIA/skills3.6k—~2.8kAutomated safety check: PassApache-2.0

Similar skills

  • Visually verify Eneru browser-dashboard changes against a live daemon or audit an exact deployment.

    149 GitHub stars~1.4k tokensUpdated 3 days ago
    DevOps & CloudAuto-check passed
  • Alicloud Acs Agent Sandbox

    cinience/alicloud-skills

    Bootstrap, create, connect to, operate, secure, scale, upgrade, troubleshoot, inspect, and tear down Alibaba Cloud Container Compute Service (ACS) Agent Sandbox environments.

    397 GitHub stars~2.7k tokensUpdated 2 mo ago
    DevOps & CloudAuto-check passed
  • Aqua Metrics

    oracle/accelerated-data-science

    Official

    Set up Prometheus and Grafana monitoring for AQUA vLLM model deployments on OCI.

    125 GitHub stars~1.5k tokensUpdated 1 mo ago
    DevOps & CloudAuto-check passed
  • Analyze the experiment precompute result-consistency canary across prod-US and prod-EU, deep-dive any issues, and produce an actionable report.

    40k GitHub stars~3.5k tokensUpdated yesterday
    DevOps & CloudAuto-check passed
  • Official

    A skill your agent uses to deploy and operate a CollectX (clx) based DOCA telemetry collector on a host or BlueField — wiring providers / counters into the collector, running the collection daemon…

    3.6k GitHub stars~2.8k tokensUpdated 2 days ago
    DevOps & CloudAuto-check passed
  • vLLM Model Serving

    Orchestra-Research/AI-Research-SKILLs

    Deploys LLMs with vLLM for high-throughput serving, covering the OpenAI-compatible server, offline batch inference, monitoring and a Docker rollout.

    13k GitHub starsUsed in 5 repos~2.3k tokens
    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

Categories

Questions about Deepgram Prod Checklist

What does Deepgram Prod Checklist do?

Execute Deepgram production deployment checklist. An agent skill from jeremylongshore/tons-of-skills-marketplace. Deepgram Prod Checklist is an agent skill from jeremylongshore/tons-of-skills-marketplace. Execute Deepgram production deployment checklist.

When should I use Deepgram Prod Checklist?

Deepgram Prod Checklist fits situations like: preparing for production launch; auditing production readiness; verifying deployment configurations.

How do I install Deepgram Prod Checklist in Claude Code?

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

How do I install Deepgram Prod Checklist in Codex?

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

Can I use Deepgram Prod Checklist 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-prod-checklist -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-prod-checklist, .gemini/skills/deepgram-prod-checklist, .github/skills/deepgram-prod-checklist and .opencode/skills/deepgram-prod-checklist in your project.

What does Deepgram Prod Checklist need to run?

Going by SKILL.md and its folder, Deepgram Prod Checklist needs credentials named DEEPGRAM_API_KEY. Our summary lists: A credential in DEEPGRAM_API_KEY. Its frontmatter pre-approves these tools: Read, Write, Edit, Grep, Bash(curl:*). Compatibility (from SKILL.md): Designed for Claude Code.

Does Deepgram Prod Checklist access the network?

SKILL.md names 1 domain. As links in the text: prometheus.io. This is read from the text; nothing was executed.

Is Deepgram Prod Checklist 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 Prod Checklist use?

Deepgram Prod Checklist 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 Prod Checklist use?

About 2.3k tokens (SKILL.md is roughly 9.1k 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 1.3k tokens, read only when the agent opens those files.

What are the alternatives to Deepgram Prod Checklist?

Skills that share tags, products or a category with Deepgram Prod Checklist: Dashboard Preview (m4r1k/Eneru, 149 stars), Alicloud Acs Agent Sandbox (cinience/alicloud-skills, 397 stars), Aqua Metrics (oracle/accelerated-data-science, 125 stars) and Analyzing Experiment Precompute Canary (PostHog/posthog, 40k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Deepgram Prod Checklist?

jeremylongshore (a GitHub user) maintains it in jeremylongshore/tons-of-skills-marketplace, which has 2,827 GitHub stars. The repository holds 3,342 skills in this directory. The repository was last updated on October 10, 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.