Skip to content

Commit 7363c8b

Browse files
rohan-tesslclaude
andcommitted
docs(audio-intelligence): restore Authentication block and diarization gotcha
Restore the standard ## Authentication client-setup block so the skill stands on its own when loaded in isolation (the listen.v1 examples below all assume `deepgramClient`). Restore the diarization-quality gotcha — runtime knowledge that doesn't live anywhere else in the skill set. Addresses GregHolmes's review feedback on #498. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent c3fd965 commit 7363c8b

1 file changed

Lines changed: 13 additions & 0 deletions

File tree

  • .agents/skills/deepgram-js-audio-intelligence

.agents/skills/deepgram-js-audio-intelligence/SKILL.md

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,18 @@ Analytics overlays applied to `/v1/listen`: summaries, topics, intents, sentimen
99

1010
**Use a different skill when:** plain transcription → `deepgram-js-speech-to-text`; analytics on text → `deepgram-js-text-intelligence`; Flux turn-taking → `deepgram-js-conversational-stt`; full-duplex agent → `deepgram-js-voice-agent`.
1111

12+
## Authentication
13+
14+
```js
15+
require("dotenv").config();
16+
17+
const { DeepgramClient } = require("@deepgram/sdk");
18+
19+
const deepgramClient = new DeepgramClient({
20+
apiKey: process.env.DEEPGRAM_API_KEY,
21+
});
22+
```
23+
1224
## Feature availability: REST vs WSS
1325

1426
| Feature | REST | WSS |
@@ -98,6 +110,7 @@ const deepgramConnection = await deepgramClient.listen.v1.createConnection({
98110
2. **`redact` accepts arrays** like `["pci", "ssn"]` despite `ListenV1Redact` being a string alias.
99111
3. **Use `keyterm`, not `keywords`, for Nova-3 biasing.**
100112
4. **Prefer `nova-3`** when mixing many overlays -- broadest feature support.
113+
5. **Diarization quality depends on audio quality and duration.** Short or noisy clips churn speakers.
101114
102115
## Example files in this repo
103116

0 commit comments

Comments
 (0)