CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

deepgram-go-text-to-speech

Use when writing or reviewing Go code in this repo that synthesizes audio with Speak v1 REST or Speak WebSockets. Route transcription work to deepgram-go-speech-to-text, voice conversation runtime work to deepgram-go-voice-agent, and repository maintenance work to deepgram-go-maintaining-sdk.

68

Quality

85%

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

86%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.

A strong single-file skill: fully executable quick-start examples for both REST and WebSocket synthesis, concrete gotchas, and a clean layered pointer structure instead of inlined API detail. The only slack is minor duplicated boilerplate and a promotional footer, which cost a little conciseness.

DimensionReasoningScore

Conciseness

Lean and competent — it assumes Claude's knowledge (no explaining what TTS, REST, or WebSockets are) and keeps sections tight. Minor trimmable material keeps it below anchor 5: the duplicated `func main() { if err := run(); err != nil { log.Fatal(err) } }` boilerplate in both quick-start examples and the promotional "Central product skills" section with its npx command.

4 / 5

Actionability

Two complete, copy-paste-ready Go programs with full import paths and error handling cover the two common cases (REST `ToSave` to file, WebSocket channel streaming with `Connect`/`Start`/`SpeakWithText`/`Flush`/`Stop`), plus a concrete model name (`aura-2-thalia-en`), an env-var command, and exact constructor and method names. Fully executable guidance covering the common cases.

5 / 5

Workflow Clarity

The usage sequence (set env → construct client → connect → speak → flush → stop) is clearly conveyed through the examples, with error checkpoints present in code ("if ok := conn.Connect(); !ok", checked `ToSave` and `SpeakWithText` returns). Not a destructive or batch operation so no cap applies, but the sequence is implicit in code rather than explicit steps with validation checkpoints, fitting anchor 4.

4 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent), and none are needed: the body is a concise overview with well-organized sections, and the "API reference (layered)" section provides clearly signaled one-level-deep pointers (in-repo source paths, OpenAPI/AsyncAPI, product docs) so detail is never inlined. This matches the anchor for a clear overview with well-signaled one-level-deep references and easy navigation.

5 / 5

Total

18

/

20

Passed

Description

78%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.

A strong, well-scoped description with an explicit "Use when" trigger and excellent sibling-skill routing that minimizes conflict risk. Its main weakness is that the "what" is only implied by the when-clause and the most natural user phrases ("text-to-speech", "TTS") are absent.

Suggestions

State what the skill provides explicitly, e.g. "Guides synthesis of audio via Speak v1 REST and WebSockets from the Go SDK, with copy-paste examples, option reference, and gotchas. Use when..."

Add the natural trigger terms "text-to-speech" and "TTS" to the description — they are the phrases users would most likely say but do not currently appear.

Optionally mention the concrete playback patterns (callback-based or channel-based) as capability keywords to strengthen specificity.

DimensionReasoningScore

Specificity

Names the domain (Go, Deepgram Speak) and several concrete surfaces ("writing or reviewing Go code", "synthesizes audio with Speak v1 REST or Speak WebSockets"), matching the anchor listing several specific actions with minor gaps; it stops short of enumerating the skill's actual capabilities (REST-to-file, streaming, callback pipelines) that the body covers.

4 / 5

Completeness

The "when" is explicit and concrete ("Use when writing or reviewing Go code in this repo that synthesizes audio with Speak v1 REST or Speak WebSockets"), but the "what" is only embedded inside the when-clause; the description never states what the skill itself provides (usage patterns, examples, gotchas for the Go SDK Speak API). This fits anchor 4 (both present, one could be more explicit) rather than anchor 5.

4 / 5

Trigger Term Quality

Good natural keyword coverage ("Go", "synthesizes audio", "Speak v1 REST", "Speak WebSockets", "transcription", "voice conversation"), but the phrases users would most naturally say — "text-to-speech" and "TTS" — never appear in the description, fitting anchor 4 rather than comprehensive anchor 5.

4 / 5

Distinctiveness Conflict Risk

It carves a clear niche (Go + Speak TTS in this repo) and explicitly routes adjacent work away ("Route transcription work to deepgram-go-speech-to-text, voice conversation runtime work to deepgram-go-voice-agent, and repository maintenance work to deepgram-go-maintaining-sdk"), giving minimal conflict risk with closely related sibling skills.

5 / 5

Total

17

/

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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

deepgram/deepgram-go-sdk

Path

.agents/skills/deepgram-go-text-to-speech/SKILL.md

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.