Agent skill

Deepgram JS Audio Intelligence

by deepgram in deepgram/deepgram-js-sdk

A skill your agent uses when writing or reviewing JavaScript/TypeScript in this repo that calls Deepgram audio analytics overlays on /v1/listen - summarize, topics, intents, sentiment, diarize…

MITAuto-check passedMedia & Creative

Install Deepgram JS Audio Intelligence

skills CLI
$ npx skills add deepgram/deepgram-js-sdk --skill deepgram-js-audio-intelligence -a claude-code

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

GitHub CLI
$ gh skill install deepgram/deepgram-js-sdk deepgram-js-audio-intelligence --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/deepgram/deepgram-js-sdk.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/deepgram-js-audio-intelligence .claude/skills/deepgram-js-audio-intelligence && 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-js-audio-intelligence
GitHub stars
276
Token cost
~1.5k tokens
SKILL.md length
422 words
Files
1
Skills in repo
7
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when writing or reviewing JavaScript/TypeScript in this repo that calls Deepgram audio analytics overlays on /v1/listen - summarize, topics, intents, sentiment, diarize…

  • Works in 5 steps: In-repo reference: reference.md → Listen… → Canonical OpenAPI (REST):… → Canonical AsyncAPI (WSS):… → …
  • Reviewing JavaScript/TypeScript in this repo that calls Deepgram audio analytics overlays on /v1/listen - summarize
  • SKILL.md covers When to use this product, Feature availability: REST vs…, Authentication and Quick start — REST with…, plus 6 more sections
  • Calls npx; reaches dpgr.am; needs DEEPGRAM_API_KEY

What it does

Deepgram JS Audio Intelligence is an agent skill from deepgram/deepgram-js-sdk. Use when writing or reviewing JavaScript/TypeScript in this repo that calls Deepgram audio analytics overlays on /v1/listen - summarize, topics, intents, sentiment, diarize, redact, detectlanguage, and entity detection. Same endpoint as plain STT, different params. Covers REST via client.listen.v1.media.transcribeUrl / transcribeFile and the WebSocket-supported subset on client.listen.v1.createConnection() / connect(). Use deepgram-js-speech-to-text for plain transcription and deepgram-js-text-intelligence for…

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Media & Creative, covering Transcription, Speech recognition and synthesis and Realtime and WebSockets. It works with Deepgram, JavaScript and TypeScript. The repository describes itself as: Official JavaScript SDK for Deepgram. The licence is MIT.

When your agent uses it

  • Reviewing JavaScript/TypeScript in this repo that calls Deepgram audio analytics overlays on /v1/listen - summarize
  • Entity detection
  • Include audio intelligence
  • Summarize audio

Example prompts

  • “audio intelligence”
  • “summarize audio”
  • “diarize”
  • “/deepgram-js-audio-intelligence”

Requirements

  • Node.js
  • A credential in DEEPGRAM_API_KEY

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. In-repo reference: reference.md → Listen V1 Media; WSS subset behavior lives in src/CustomClient.ts and…
  2. Canonical OpenAPI (REST): https://developers.deepgram.com/openapi.yaml
  3. Canonical AsyncAPI (WSS): https://developers.deepgram.com/asyncapi.yaml
  4. Context7: library ID /llmstxt/developers_deepgram_llms_txt
  5. Product docs

What it can do on your machine

Read from SKILL.md and the folder at commit 4b3dc3e. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npx

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

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • dpgr.am

    Also links to:

    • developers.deepgram.com

    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.

Context cost

Deepgram JS Audio Intelligence loads about 1.5k tokens when it runs. Until then it costs about 184 tokens; SKILL.md has 422 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~184
When it runs · the whole SKILL.md, loaded when a task matches
~1.5k

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 deepgram/deepgram-js-sdk at commit 4b3dc3e, republished under its MIT licence (© deepgram). 422 words, ~1,523 tokens.

Download SKILL.mdSave it as .claude/skills/deepgram-js-audio-intelligence/SKILL.md (or your agent's skills folder).
name
deepgram-js-audio-intelligence
description
Use when writing or reviewing JavaScript/TypeScript in this repo that calls Deepgram audio analytics overlays on `/v1/listen` - summarize, topics, intents, sentiment, diarize, redact, detect_language, and entity detection. Same endpoint as plain STT, different params. Covers REST via `client.listen.v1.media.transcribeUrl` / `transcribeFile` and the WebSocket-supported subset on `client.listen.v1.createConnection()` / `connect()`. Use `deepgram-js-speech-to-text` for plain transcription and `deepgram-js-text-intelligence` for analytics on already-transcribed text. Triggers include "audio intelligence", "summarize audio", "diarize", "sentiment from audio", "redact PII", and "detect language audio".

Using Deepgram Audio Intelligence (JavaScript / TypeScript SDK)

Analytics overlays applied to /v1/listen: summaries, topics, intents, sentiment, language detection, diarization, redaction, entities. Same client surface as STT; turn features on with parameters.

When to use this product

  • You have audio and want analytics returned alongside the transcript.
  • REST is the primary path; the WebSocket path supports only a subset of intelligence features.

Use a different skill when:

  • You just want transcript output → deepgram-js-speech-to-text.
  • You already have text and want analytics on that text → deepgram-js-text-intelligence.
  • You need Flux turn-taking → deepgram-js-conversational-stt.
  • You need a full interactive voice agent → deepgram-js-voice-agent.

Feature availability: REST vs WSS

FeatureRESTWSS
diarizeyesyes
redactyesyes
detect_entitiesyesyes
punctuate, smart_formatyesyes
summarizeyesno in current WSS connect args
topicsyesno
intentsyesno
sentimentyesno
detect_languageyesno

Authentication

js
require("dotenv").config();

const { DeepgramClient } = require("@deepgram/sdk");

const deepgramClient = new DeepgramClient({
  apiKey: process.env.DEEPGRAM_API_KEY,
});

Quick start — REST with analytics

From examples/22-transcription-advanced-options.ts:

js
const data = await deepgramClient.listen.v1.media.transcribeUrl({
  url: "https://dpgr.am/spacewalk.wav",
  model: "nova-3",
  language: "en",
  punctuate: true,
  paragraphs: true,
  utterances: true,
  smart_format: true,
  sentiment: true,
  topics: true,
  custom_topic: "custom_topic",
  custom_topic_mode: "extended",
  intents: true,
  custom_intent: "custom_intent",
  custom_intent_mode: "extended",
  detect_entities: true,
  detect_language: true,
  diarize: true,
  keyterm: ["keyword1", "keyword2"],
  redact: ["pci", "ssn"],
});

Quick start — WSS subset

Start from examples/07-transcription-live-websocket.ts and keep the same socket flow, but only use WSS-supported intelligence flags such as diarize, redact, and detect_entities in the connection args.

js
const deepgramConnection = await deepgramClient.listen.v1.createConnection({
  model: "nova-3",
  diarize: true,
  redact: "pci",
  detect_entities: true,
});

Key parameters / API surface

  • Analytics flags: summarize, topics, intents, sentiment, detect_language, detect_entities, diarize, redact, custom_topic, custom_topic_mode, custom_intent, custom_intent_mode.
  • Standard STT flags still apply: model, language, encoding, sample_rate, punctuate, smart_format, utterances, paragraphs, multichannel.
  • Nova-3-specific biasing in repo examples uses keyterm, not keywords.

API reference (layered)

  1. In-repo reference: reference.md → Listen V1 Media; WSS subset behavior lives in src/CustomClient.ts and src/api/resources/listen/resources/v1/client/{Client,Socket}.ts.
  2. Canonical OpenAPI (REST): https://developers.deepgram.com/openapi.yaml
  3. Canonical AsyncAPI (WSS): https://developers.deepgram.com/asyncapi.yaml
  4. Context7: library ID /llmstxt/developers_deepgram_llms_txt
  5. Product docs:
Show full SKILL.md (163 more words)Show less

Gotchas

  1. summarize on /v1/listen is versioned, not plain boolean. The generated REST surface and examples point at "v2".
  2. Most intelligence flags are REST-only. Current WSS connect args do not expose topics, intents, sentiment, summarize, or detect_language.
  3. redact typing is looser in practice than in the generated alias. Examples pass arrays like ["pci", "ssn"], even though ListenV1Redact itself is just a string alias.
  4. Use keyterm for Nova-3 biasing. examples/22-transcription-advanced-options.ts explicitly notes keywords are not supported for Nova-3.
  5. Model/feature support is product-side. nova-3 is the safest choice when mixing many overlays.
  6. Diarization quality depends on audio quality and duration. Short or noisy clips churn speakers.

Example files in this repo

  • examples/22-transcription-advanced-options.ts
  • examples/04-transcription-prerecorded-url.ts
  • examples/05-transcription-prerecorded-file.ts
  • examples/07-transcription-live-websocket.ts

Central product skills

For cross-language Deepgram product knowledge — the consolidated API reference, documentation finder, focused runnable recipes, third-party integration examples, and MCP setup — install the central skills:

bash
npx skills add deepgram/skills

This SDK ships language-idiomatic code skills; deepgram/skills ships cross-language product knowledge (see api, docs, recipes, examples, starters, setup-mcp).

© deepgram, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/deepgram-js-audio-intelligence of deepgram/deepgram-js-sdk.

Open the folder on GitHubat commit 4b3dc3e

Compare with similar skills

Deepgram JS Audio Intelligence 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 JS Audio Intelligence compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Deepgram JS Audio Intelligence this skilldeepgram/deepgram-js-sdk276—~1.5kAutomated safety check: PassMIT
Gemini Live API Devgoogle-gemini/gemini-skills4.3k—~4.6kAutomated safety check: PassApache-2.0
Speech Engineelevenlabs/skills479—~2.5kAutomated safety check: WarnMIT
Deepgram Python Speech-to-Textdeepgram/deepgram-python-sdk469—~2.9kAutomated safety check: PassMIT
Azure AI Voicelive TSmicrosoft/skills3.1k6 repos~3.4kAutomated safety check: PassMIT
9Router Speech-to-Textdecolua/9router30k—~745Automated safety check: PassMIT

Similar skills

  • Gemini Live API Dev

    google-gemini/gemini-skills

    Official

    A skill your agent uses when building real-time, bidirectional streaming applications with the Gemini Live API, or migrating legacy Live models (2.0/2.5/3.1) to Gemini 3.8 Live.

    4.3k GitHub stars~4.6k tokensUpdated today
    Backend & APIsAuto-check passed
  • Speech Engine

    elevenlabs/skills

    Add real-time voice conversations to a custom agent runtime with ElevenLabs Speech Engine.

    479 GitHub stars~2.5k tokensUpdated today
    Media & CreativeAuto-check: warnings
  • Deepgram Python Speech-to-Text

    deepgram/deepgram-python-sdk

    Covers basic transcription with the Deepgram Python SDK's listen.v1 endpoint, for one-shot REST transcription of a file or URL and live WebSocket streaming with interim results.

    469 GitHub stars~2.9k tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • Azure AI Voicelive TS

    microsoft/skills

    Official

    Azure AI Voice Live SDK for JavaScript/TypeScript. An agent skill from microsoft/skills.

    3.1k GitHub starsUsed in 6 repos~3.4k tokens
    Backend & APIsAuto-check passed
  • 9Router Speech-to-Text

    decolua/9router

    Transcribes audio files into text or subtitles through 9Router's Whisper-compatible endpoint, using models from OpenAI, Groq, Gemini, Deepgram and others.

    30k GitHub stars~745 tokensUpdated 6 days ago
    Media & CreativeAuto-check passed
  • Deepgram Python Text-to-Speech

    deepgram/deepgram-python-sdk

    Guides Python code that calls Deepgram Text-to-Speech v1, covering one-shot REST, streaming WebSocket and the TextBuilder helper.

    469 GitHub stars~1.8k tokensUpdated yesterday
    Media & CreativeAuto-check passed

More from deepgram/deepgram-js-sdk

  • Deepgram JS Conversational Stt

    deepgram/deepgram-js-sdk

    A skill your agent uses when writing or reviewing JavaScript/TypeScript in this repo that calls Deepgram Conversational STT v2 / Flux (/v2/listen) for turn-aware streaming transcription.

    276 GitHub stars~1.3k tokensUpdated 5 days ago
    Auto-check passed
  • Deepgram JS Management API

    deepgram/deepgram-js-sdk

    A skill your agent uses when writing or reviewing JavaScript/TypeScript in this repo that calls Deepgram Management APIs for projects, API keys, members, invites, requests, usage, billing, models…

    276 GitHub stars~1.7k tokensUpdated 5 days ago
    Auto-check passed
  • Deepgram JS Speech To Text

    deepgram/deepgram-js-sdk

    A skill your agent uses when writing or reviewing JavaScript/TypeScript in this repo that calls Deepgram Speech-to-Text v1 (/v1/listen) for prerecorded or live audio transcription.

    276 GitHub stars~1.8k tokensUpdated 5 days ago
    Auto-check passed
  • Deepgram JS Text Intelligence

    deepgram/deepgram-js-sdk

    A skill your agent uses when writing or reviewing JavaScript/TypeScript in this repo that calls Deepgram Text Intelligence / Read (/v1/read) for sentiment, summarization, topic detection, and intent…

    276 GitHub stars~1.1k tokensUpdated 5 days ago
    Auto-check passed
  • Deepgram JS Text To Speech

    deepgram/deepgram-js-sdk

    A skill your agent uses when writing or reviewing JavaScript/TypeScript in this repo that calls Deepgram Text-to-Speech v1 (/v1/speak) for audio synthesis.

    276 GitHub stars~1.4k tokensUpdated 5 days ago
    Auto-check passed
  • Deepgram JS Voice Agent

    deepgram/deepgram-js-sdk

    A skill your agent uses when writing or reviewing JavaScript/TypeScript in this repo that builds an interactive voice agent via agent.deepgram.com/v1/agent/converse.

    276 GitHub stars~1.6k tokensUpdated 5 days ago
    Auto-check passed

Questions about Deepgram JS Audio Intelligence

What does Deepgram JS Audio Intelligence do?

A skill your agent uses when writing or reviewing JavaScript/TypeScript in this repo that calls Deepgram audio analytics overlays on /v1/listen - summarize, topics, intents, sentiment, diarize…. Deepgram JS Audio Intelligence is an agent skill from deepgram/deepgram-js-sdk. Use when writing or reviewing JavaScript/TypeScript in this repo that calls Deepgram audio analytics overlays on /v1/listen - summarize, topics, intents, sentiment, diarize, redact, detectlanguage, and entity detection.

When should I use Deepgram JS Audio Intelligence?

Deepgram JS Audio Intelligence fits situations like: reviewing JavaScript/TypeScript in this repo that calls Deepgram audio analytics overlays on /v1/listen - summarize; entity detection; include audio intelligence; summarize audio.

How do I install Deepgram JS Audio Intelligence in Claude Code?

Run `npx skills add deepgram/deepgram-js-sdk --skill deepgram-js-audio-intelligence -a claude-code`. Or copy the skill folder (.agents/skills/deepgram-js-audio-intelligence in deepgram/deepgram-js-sdk) into .claude/skills/deepgram-js-audio-intelligence in your project. Claude Code loads it when a task matches its description.

How do I install Deepgram JS Audio Intelligence in Codex?

Run `npx skills add deepgram/deepgram-js-sdk --skill deepgram-js-audio-intelligence -a codex`. Or copy the skill folder (.agents/skills/deepgram-js-audio-intelligence in deepgram/deepgram-js-sdk) into .agents/skills/deepgram-js-audio-intelligence in your project. Codex loads it when a task matches its description.

Can I use Deepgram JS Audio Intelligence 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 deepgram/deepgram-js-sdk --skill deepgram-js-audio-intelligence -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-js-audio-intelligence, .gemini/skills/deepgram-js-audio-intelligence, .github/skills/deepgram-js-audio-intelligence and .opencode/skills/deepgram-js-audio-intelligence in your project.

What does Deepgram JS Audio Intelligence need to run?

Going by SKILL.md and its folder, Deepgram JS Audio Intelligence needs the command-line tools its instructions call (npx) and credentials named DEEPGRAM_API_KEY. Our summary lists: Node.js; A credential in DEEPGRAM_API_KEY.

Does Deepgram JS Audio Intelligence access the network?

SKILL.md names 2 domains. In commands or code: dpgr.am; the agent is likely to contact it when it follows the instructions. As links in the text: developers.deepgram.com. This is read from the text; nothing was executed.

Is Deepgram JS Audio Intelligence 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 JS Audio Intelligence use?

Deepgram JS Audio Intelligence is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Deepgram JS Audio Intelligence use?

About 1.5k tokens (SKILL.md is roughly 6.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Deepgram JS Audio Intelligence?

Skills that share tags, products or a category with Deepgram JS Audio Intelligence: Gemini Live API Dev (google-gemini/gemini-skills, 4.3k stars), Speech Engine (elevenlabs/skills, 479 stars), Deepgram Python Speech-to-Text (deepgram/deepgram-python-sdk, 469 stars) and Azure AI Voicelive TS (microsoft/skills, 3.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Deepgram JS Audio Intelligence?

deepgram (a GitHub organization) maintains it in deepgram/deepgram-js-sdk, which has 276 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on October 2, 2026.

Source: deepgram/deepgram-js-sdk on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.