deepgram-go-audio-intelligence
Use when writing or reviewing Go code in this repo that applies summaries, topics, intents, sentiment, language detection, diarization, redaction, or entity extraction to audio inputs through Listen v1 REST. Route plain transcription to deepgram-go-speech-to-text and plain-text Read requests to deepgram-go-text-intelligence.
94
92%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Advisory
Suggest reviewing before use
Quality
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is an excellent skill description that clearly defines its scope (audio intelligence features via Listen v1 REST in Go), provides explicit trigger guidance with a 'Use when' clause, and proactively reduces conflict risk by naming sibling skills and routing criteria. The description is concise yet comprehensive, listing specific capabilities and disambiguation rules.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: summaries, topics, intents, sentiment, language detection, diarization, redaction, entity extraction applied to audio inputs through Listen v1 REST. Also specifies routing rules for plain transcription and plain-text Read requests. | 3 / 3 |
Completeness | Clearly answers both 'what' (applies audio intelligence features via Listen v1 REST) and 'when' (explicitly starts with 'Use when writing or reviewing Go code' and provides routing guidance for when NOT to use it, directing to other skills instead). | 3 / 3 |
Trigger Term Quality | Includes highly natural and specific trigger terms users would say: 'Go code', 'summaries', 'topics', 'intents', 'sentiment', 'language detection', 'diarization', 'redaction', 'entity extraction', 'audio', 'Listen v1 REST', plus routing terms like 'transcription' and 'text intelligence'. Good coverage of domain-specific terms. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with explicit boundary-drawing: routes plain transcription to deepgram-go-speech-to-text and plain-text Read requests to deepgram-go-text-intelligence, clearly carving out its niche as the audio intelligence/analysis skill distinct from related skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured SDK skill that provides immediately actionable Go code with clear scoping of when to use it versus sibling skills. The key parameters and response type locations are precisely documented. Minor verbosity in the API reference listing and the 'Central product skills' promotional section slightly dilute the token efficiency, but overall the skill is effective and well-organized.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is mostly efficient but includes some unnecessary content. The 'Central product skills' section at the bottom and the extensive API reference links add bulk. The 'Gotchas' section partially repeats information already stated (REST-only nature). However, it avoids explaining basic Go or SDK concepts. | 2 / 3 |
Actionability | The quick start provides a fully executable, copy-paste-ready Go program with correct imports, proper error handling, and a concrete example URL. Key parameters are listed with their exact field names and types, and response payload locations are specified precisely. | 3 / 3 |
Workflow Clarity | This is essentially a single-task skill (make a REST call with analytics flags). The workflow is unambiguous: set API key → create client → call FromURL with options → read response fields. For this level of complexity, the clarity is sufficient. No destructive or batch operations require validation checkpoints. | 3 / 3 |
Progressive Disclosure | The skill is well-structured with clear sections progressing from 'when to use' → quick start → parameters → layered API references → gotchas → examples. References to other files (example files, in-repo docs, external docs) are clearly signaled and one level deep. Cross-references to related skills are explicit. | 3 / 3 |
Total | 11 / 12 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 — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
- Repository
- deepgram/deepgram-go-sdk
- Commit
b7c92f4
- 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.