CtrlK
BlogDocsLog inGet started
Tessl Logo

deepgram-java-text-to-speech

Use when writing or reviewing Java code in this repo that calls Deepgram Text-to-Speech v1 (`/v1/speak`) for audio synthesis. Covers one-shot REST via `client.speak().v1().audio().generate(...)` and streaming synthesis via `client.speak().v1().v1WebSocket()`. Use `deepgram-java-voice-agent` for full-duplex assistants instead of one-way synthesis. Triggers include "tts", "text to speech", "speak", "aura", "streaming tts", and "speak websocket".

74

Quality

91%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

82%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body delivers runnable REST, WebSocket, and async examples with concrete API surface and practical gotchas, well-organized into clear sections. It is slightly held back by a promotional cross-skill block and a dense inline parameter list that could live in a reference file.

Suggestions

Move the 'Key parameters / API surface' list into a references/ file (or trim to the most-used params) to reduce inline density and improve progressive disclosure.

Trim or relocate the 'Central product skills' promotional block so the SKILL.md stays focused on TTS usage.

Add a brief validation/check step for the WebSocket flow (e.g. confirm `onDisconnected` fired and the output file is non-empty) to lift workflow clarity.

DimensionReasoningScore

Conciseness

The body is largely lean with copy-paste code and tight gotchas that assume Claude's competence (e.g. 'REST returns an `InputStream`, not JSON.'); not 5 because the 'Central product skills' promo block and the five-entry 'API reference (layered)' list could be trimmed, and not 3 because nearly everything earns its place.

4 / 5

Actionability

Provides fully executable, copy-paste-ready code for REST, WebSocket, and async paths plus a concrete 'Verified REST params' / WSS options list; not below 5 because the common cases are covered with runnable examples.

5 / 5

Workflow Clarity

The WebSocket example is explicitly sequenced (connect → sendText → sendFlush → sendClose) with ordering gotchas ('Flush before close') and a clear REST-vs-WebSocket decision guide; not 5 because there are no validation/feedback checkpoints, and not 3 because the sequence and ordering constraints are clear.

4 / 5

Progressive Disclosure

Good section structure with a well-signaled 'API reference (layered)' section pointing to one-level-deep sources (repo paths, OpenAPI/AsyncAPI URLs, Context7, product docs); not 5 because the inline 'Key parameters / API surface' list is somewhat dense and no bundle reference files are used to offload it, and not 3 because references are clearly signaled and only one level deep.

4 / 5

Total

17

/

20

Passed

Description

100%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is specific, trigger-rich, and explicitly covers both what the skill does and when to use it, while clearly disambiguating from the related voice-agent skill. It is a strong, well-scoped trigger description.

DimensionReasoningScore

Specificity

Names multiple concrete actions — 'writing or reviewing Java code', 'one-shot REST via `client.speak().v1().audio().generate(...)`', and 'streaming synthesis via `client.speak().v1().v1WebSocket()`' — with specific SDK method calls, giving comprehensive coverage; not below 5 because no concrete action is missing for this scope.

5 / 5

Completeness

Explicitly answers both what ('audio synthesis' via Deepgram TTS v1, REST and streaming) and when ('Use when writing or reviewing Java code in this repo that calls Deepgram Text-to-Speech v1') with concrete trigger phrases; not 4 because both halves are explicit and specific.

5 / 5

Trigger Term Quality

Lists comprehensive natural triggers — 'tts', 'text to speech', 'speak', 'aura', 'streaming tts', and 'speak websocket' — including synonyms a user would actually say; not below 5 because common variations are all present.

5 / 5

Distinctiveness Conflict Risk

Clear niche (Deepgram TTS Java SDK) with an explicit disambiguator — 'Use `deepgram-java-voice-agent` for full-duplex assistants instead of one-way synthesis' — minimizing conflict risk; not below 5 because it actively distinguishes from the nearest sibling skill.

5 / 5

Total

20

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
deepgram/deepgram-java-sdk
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.