---
title: "deepgram/skills"
description: "Agent Skills from deepgram/skills."
source: https://github.com/deepgram/skills
ref: main
license: null
licenseName: "No licence detected"
canonical: https://skillsdocs.com/deepgram/skills
base: https://github.com/deepgram/skills/blob/main/
chapters: 6
inlined: 0
withheld: 6
words: 2442
updated: 2026-05-01T22:11:21Z
generator: "Skills Docs"
---

> **deepgram/skills** — every Agent Skill in this repository, inlined verbatim.
>
> Canonical HTML: https://skillsdocs.com/deepgram/skills
> Per-chapter Markdown: https://skillsdocs.com/deepgram/skills/<skill>.md
> Machine manifest: https://skillsdocs.com/deepgram/skills/.well-known/agent-skills/index.json
> JSON: https://skillsdocs.com/api/v1/books/deepgram/skills
> Install: `npx skills add deepgram/skills`
> Upstream: https://github.com/deepgram/skills @ `main`
> Licence: No licence detected — all rights reserved by its authors
>
> Content is mirrored from GitHub and © its authors, served unmodified. Takedown: https://github.com/kyleledbetter/skillsdocs/issues/new?labels=takedown&title=Takedown+request

# deepgram/skills


- **Chapters:** 6
- **Inlined:** 0 (licence detected)
- **Words:** 2,442
- **Reading time:** 11 min
- **Stars:** 16

## Table of contents

1. [api](https://skillsdocs.com/deepgram/skills/api.md) — Not licensed for republication — link only.
2. [docs](https://skillsdocs.com/deepgram/skills/docs.md) — Not licensed for republication — link only.
3. [examples](https://skillsdocs.com/deepgram/skills/examples.md) — Not licensed for republication — link only.
4. [recipes](https://skillsdocs.com/deepgram/skills/recipes.md) — Not licensed for republication — link only.
5. [setup-mcp](https://skillsdocs.com/deepgram/skills/setup-mcp.md) — Not licensed for republication — link only.
6. [starters](https://skillsdocs.com/deepgram/skills/starters.md) — Not licensed for republication — link only.

## Licence notice

6 of 6 chapters in this book have no licence that we could detect, at either the repository or the skill level. Their bodies are **not** reproduced here and they are **not** listed in the Agent Skills manifest. Read them upstream:

- api — https://github.com/deepgram/skills/blob/main/skills/api/SKILL.md
- docs — https://github.com/deepgram/skills/blob/main/skills/docs/SKILL.md
- examples — https://github.com/deepgram/skills/blob/main/skills/examples/SKILL.md
- recipes — https://github.com/deepgram/skills/blob/main/skills/recipes/SKILL.md
- setup-mcp — https://github.com/deepgram/skills/blob/main/skills/setup-mcp/SKILL.md
- starters — https://github.com/deepgram/skills/blob/main/skills/starters/SKILL.md

## Front matter

_The repository README, verbatim except that relative links are resolved against https://github.com/deepgram/skills/blob/main/._

# Deepgram Skills

Skills are folders of instructions and resources that AI coding tools load to help you build with Deepgram faster. Each skill teaches your tool how to use a specific part of the Deepgram platform — from API reference to finding the right starter app.

For more information, check out:
- [Deepgram Documentation](https://developers.deepgram.com)
- [Deepgram API Reference](https://developers.deepgram.com/reference/deepgram-api-overview)
- [Ask Deepgram AI](https://developers.deepgram.com/ask-ai)

# About This Repository

This repository contains skills for building with Deepgram's speech-to-text, text-to-speech, voice agent, and audio intelligence APIs. Skills are agent-agnostic — plain markdown that any AI coding tool can consume.

Deepgram ships two actively maintained, industry-leading speech-to-text model families:

- **Nova** (`/v1/listen`) — general-purpose transcription with a rich intelligence feature set (diarize, summarize, sentiment, topics, intents). Use for captions, subtitles, batch, and general live streaming.
- **Flux** (`/v2/listen`, `model=flux-general-en`) — conversational STT with built-in turn detection. Use for voice agents and interactive assistants. See the `api` skill for the full Nova vs Flux decision guide.

Some skills are hand-written, others are generated from Deepgram's [OpenAPI](https://dpgr.am/openapi.yml) and [AsyncAPI](https://dpgr.am/asyncapi.yml) specs.

## Skills

- [./skills](https://github.com/deepgram/skills/blob/main/skills): All Deepgram skills
- [./template](https://github.com/deepgram/skills/blob/main/template): Skill template for creating new skills
- [./scripts](https://github.com/deepgram/skills/blob/main/scripts): Scripts for fetching specs and generating skills

# Skills

| Skill | Description |
|-------|-------------|
| [api](https://github.com/deepgram/skills/blob/main/skills/api) | Full API reference for all Deepgram REST and WebSocket APIs, generated from OpenAPI and AsyncAPI specs |
| [docs](https://github.com/deepgram/skills/blob/main/skills/docs) | Find the right Deepgram documentation for any task |
| [starters](https://github.com/deepgram/skills/blob/main/skills/starters) | Clone a ready-to-run demo app in your language and start building — 13 frameworks, 7 features |
| [recipes](https://github.com/deepgram/skills/blob/main/skills/recipes) | Focused runnable recipes for one feature × one language — minimal working code (< 50 lines) |
| [examples](https://github.com/deepgram/skills/blob/main/skills/examples) | Integration examples with third-party platforms (Twilio, LiveKit, LangChain, Vercel AI SDK, etc.) |
| [setup-mcp](https://github.com/deepgram/skills/blob/main/skills/setup-mcp) | Set up the Deepgram MCP server for querying docs directly from your AI coding tool |

## SDK-Specific Skills

Each Deepgram SDK repository publishes its own set of language-idiomatic skills under `.agents/skills/`:

```bash
npx skills add deepgram/deepgram-python-sdk     # Python
npx skills add deepgram/deepgram-js-sdk         # JavaScript / TypeScript
npx skills add deepgram/deepgram-java-sdk       # Java
npx skills add deepgram/deepgram-go-sdk         # Go
npx skills add deepgram/deepgram-rust-sdk       # Rust
npx skills add deepgram/deepgram-swift-sdk      # Swift
npx skills add deepgram/deepgram-kotlin-sdk     # Kotlin
npx skills add deepgram/deepgram-dotnet-sdk     # C# / .NET
npx skills add deepgram/deepgram-browser-sdk    # Browser TypeScript
```

Each SDK ships 7 product skills named `deepgram-{lang}-{product}` plus a maintainer skill `deepgram-{lang}-maintaining-sdk`. Example names for the Python SDK:

- `deepgram-python-speech-to-text`
- `deepgram-python-text-to-speech`
- `deepgram-python-text-intelligence`
- `deepgram-python-audio-intelligence`
- `deepgram-python-voice-agent`
- `deepgram-python-conversational-stt`
- `deepgram-python-management-api`
- `deepgram-python-maintaining-sdk`

The `deepgram-{lang}-` prefix keeps names globally unique so installing skills from multiple SDKs never overwrites another SDK's skills.

This `deepgram/skills` repo covers product contracts (API reference, docs, starters, recipes, integrations, MCP). The SDK repos cover language-specific usage.

# Install

## Any AI coding tool

Works with Claude Code, Cursor, Windsurf, GitHub Copilot, Gemini CLI, and [30+ others](https://github.com/vercel-labs/skills):

```bash
npx skills add deepgram/skills
```

## Claude Code (native plugin system)

Register this repository as a plugin marketplace:

```
/plugin marketplace add deepgram/skills
```

Then install the Deepgram plugin:

```
/plugin install deepgram@deepgram-agent-skills
```

This gives you the following slash commands:

- `/deepgram:api` — Deepgram API reference
- `/deepgram:docs` — Find the right documentation
- `/deepgram:starters` — Clone a starter app
- `/deepgram:recipes` — Focused runnable recipes for one feature × one language
- `/deepgram:examples` — Integration examples with third-party platforms
- `/deepgram:setup-mcp` — Set up the Deepgram MCP server

You can also install SDK-specific skill plugins from the same marketplace:

```
/plugin install deepgram-js-sdk@deepgram-agent-skills
/plugin install deepgram-python-sdk@deepgram-agent-skills
/plugin install deepgram-java-sdk@deepgram-agent-skills
/plugin install deepgram-go-sdk@deepgram-agent-skills
/plugin install deepgram-rust-sdk@deepgram-agent-skills
/plugin install deepgram-dotnet-sdk@deepgram-agent-skills
```

Each SDK plugin installs the 7 language-idiomatic skills from that SDK's repository.

# Creating a Skill

Skills are a folder with a `SKILL.md` file containing YAML frontmatter and instructions. Use the [template](https://github.com/deepgram/skills/blob/main/template/SKILL.md) as a starting point:

```markdown
---
name: my-skill-name
description: A clear description of what this skill does and when to use it.
---

# My Skill Name

[Instructions that your AI tool will follow when this skill is active]
```

The frontmatter requires two fields:
- `name` — A unique identifier for your skill (lowercase, hyphens for spaces)
- `description` — What the skill does and when to use it

## Generating API Reference Skills

The API reference skills are generated from Deepgram's specs. To regenerate:

```sh
# Fetch the latest specs
bun run scripts/fetch-specs.ts https://dpgr.am/openapi.yml https://dpgr.am/asyncapi.yml

# Generate reference markdown
bun install && bun run scripts/generate-skills.ts
```

---

<!-- chapter:begin slug=api position=1 -->

## 1. api

Deepgram API reference for speech-to-text, text-to-speech, voice agents, audio intelligence, and account management. Use whenever building with Deepgram APIs — REST or WebSocket. Covers authentication, all endpoints, query parameters, request/response schemas, and WebSocket message formats. Reference files are organized by domain: listen (STT), speak (TTS), agent (voice agents), read (text/audio intelligence), models, projects, auth, and self-hosted.

- **Source:** https://github.com/deepgram/skills/blob/main/skills/api/SKILL.md
- **Raw:** https://raw.githubusercontent.com/deepgram/skills/main/skills/api/SKILL.md
- **Markdown:** https://skillsdocs.com/deepgram/skills/api.md
- **Licence:** No licence detected — all rights reserved by its authors

Bundled files (8), referenced from this skill's directory:
  - `references/agent.md` — https://raw.githubusercontent.com/deepgram/skills/main/skills/api/references/agent.md
  - `references/auth.md` — https://raw.githubusercontent.com/deepgram/skills/main/skills/api/references/auth.md
  - `references/listen.md` — https://raw.githubusercontent.com/deepgram/skills/main/skills/api/references/listen.md
  - `references/models.md` — https://raw.githubusercontent.com/deepgram/skills/main/skills/api/references/models.md
  - `references/projects.md` — https://raw.githubusercontent.com/deepgram/skills/main/skills/api/references/projects.md
  - `references/read.md` — https://raw.githubusercontent.com/deepgram/skills/main/skills/api/references/read.md
  - `references/self-hosted.md` — https://raw.githubusercontent.com/deepgram/skills/main/skills/api/references/self-hosted.md
  - `references/speak.md` — https://raw.githubusercontent.com/deepgram/skills/main/skills/api/references/speak.md

_Body withheld: no licence could be detected for this skill. Read it upstream._

<!-- chapter:end slug=api -->

---

<!-- chapter:begin slug=docs position=2 -->

## 2. docs

Find the right Deepgram documentation for any task. Use whenever someone needs help locating docs, understanding which API to use, or wants to ask questions about Deepgram. Covers all product areas: speech-to-text, text-to-speech, voice agents, audio intelligence, and self-hosted deployments.

- **Source:** https://github.com/deepgram/skills/blob/main/skills/docs/SKILL.md
- **Raw:** https://raw.githubusercontent.com/deepgram/skills/main/skills/docs/SKILL.md
- **Markdown:** https://skillsdocs.com/deepgram/skills/docs.md
- **Licence:** No licence detected — all rights reserved by its authors

_Body withheld: no licence could be detected for this skill. Read it upstream._

<!-- chapter:end slug=docs -->

---

<!-- chapter:begin slug=examples position=3 -->

## 3. examples

Find working Deepgram integration examples with third-party platforms and frameworks. Use whenever someone wants to integrate Deepgram with Twilio, LiveKit, LangChain, Vercel AI SDK, Discord, Vonage, Pipecat, Expo, FastAPI, Cloudflare Workers, Slack, Telegram, LlamaIndex, Zoom, Next.js, Nuxt, Django, SvelteKit, NestJS, Spring Boot, CrewAI, Riverside, SignalWire, and more. Examples are full runnable integration demos, not minimal feature snippets.

- **Source:** https://github.com/deepgram/skills/blob/main/skills/examples/SKILL.md
- **Raw:** https://raw.githubusercontent.com/deepgram/skills/main/skills/examples/SKILL.md
- **Markdown:** https://skillsdocs.com/deepgram/skills/examples.md
- **Licence:** No licence detected — all rights reserved by its authors

_Body withheld: no licence could be detected for this skill. Read it upstream._

<!-- chapter:end slug=examples -->

---

<!-- chapter:begin slug=recipes position=4 -->

## 4. recipes

Find focused, runnable Deepgram recipes for a specific feature × language. Use whenever someone wants a minimal working code snippet for ONE feature (transcribe URL, diarize, smart-format, voice agent connect, etc.) rather than a full starter app. Recipes are under 50 lines, read DEEPGRAM_API_KEY from env, and ship with a runnable example_test. Covers Python, JavaScript, Go, .NET, Java, Rust, and the Deepgram CLI.

- **Source:** https://github.com/deepgram/skills/blob/main/skills/recipes/SKILL.md
- **Raw:** https://raw.githubusercontent.com/deepgram/skills/main/skills/recipes/SKILL.md
- **Markdown:** https://skillsdocs.com/deepgram/skills/recipes.md
- **Licence:** No licence detected — all rights reserved by its authors

_Body withheld: no licence could be detected for this skill. Read it upstream._

<!-- chapter:end slug=recipes -->

---

<!-- chapter:begin slug=setup-mcp position=5 -->

## 5. setup-mcp

Set up the Deepgram MCP server for your AI coding tool. Checks whether the Deepgram CLI (dg/deepctl) is installed: if so, uses the local CLI MCP server (dg mcp) for full tool access; otherwise offers the hosted documentation MCP or suggests installing the CLI. Use whenever someone wants to install Deepgram's agentic tools, set up the MCP server, or connect their editor to Deepgram.

- **Source:** https://github.com/deepgram/skills/blob/main/skills/setup-mcp/SKILL.md
- **Raw:** https://raw.githubusercontent.com/deepgram/skills/main/skills/setup-mcp/SKILL.md
- **Markdown:** https://skillsdocs.com/deepgram/skills/setup-mcp.md
- **Licence:** No licence detected — all rights reserved by its authors

_Body withheld: no licence could be detected for this skill. Read it upstream._

<!-- chapter:end slug=setup-mcp -->

---

<!-- chapter:begin slug=starters position=6 -->

## 6. starters

Clone a ready-to-run Deepgram demo app and start building on top of it. Use whenever someone wants a quick working demo, needs to prototype with Deepgram, or is starting a new project that uses speech-to-text, text-to-speech, voice agents, audio intelligence, or live streaming. Match the user's language, framework, and desired Deepgram feature to the right starter.

- **Source:** https://github.com/deepgram/skills/blob/main/skills/starters/SKILL.md
- **Raw:** https://raw.githubusercontent.com/deepgram/skills/main/skills/starters/SKILL.md
- **Markdown:** https://skillsdocs.com/deepgram/skills/starters.md
- **Licence:** No licence detected — all rights reserved by its authors

_Body withheld: no licence could be detected for this skill. Read it upstream._

<!-- chapter:end slug=starters -->