Create a minimal working Deepgram transcription example. Use when starting a new Deepgram integration, testing your setup, or learning basic Deepgram API patterns. Trigger: "deepgram hello world", "deepgram example", "deepgram quick start", "simple transcription", "transcribe audio".
80
77%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./plugins/saas-packs/deepgram-pack/skills/deepgram-hello-world/SKILL.mdQuality
Discovery
89%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 a solid description with excellent trigger terms and clear 'what/when' guidance. Its main weakness is that the capability description is somewhat thin—it says 'create a minimal working example' but doesn't enumerate the specific actions or components involved. Overall it would perform well in skill selection.
Suggestions
Add more specific concrete actions, e.g., 'Sets up API authentication, sends audio to Deepgram's speech-to-text endpoint, and parses the JSON transcript response.'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | It names the domain (Deepgram transcription) and one action (create a minimal working example), but doesn't list multiple concrete actions like 'configure API keys, send audio to endpoint, parse transcript response'. | 2 / 3 |
Completeness | Clearly answers both 'what' (create a minimal working Deepgram transcription example) and 'when' (starting a new integration, testing setup, learning basic patterns) with explicit trigger terms. | 3 / 3 |
Trigger Term Quality | Explicitly lists natural trigger terms users would say: 'deepgram hello world', 'deepgram example', 'deepgram quick start', 'simple transcription', 'transcribe audio'. These cover common variations well. | 3 / 3 |
Distinctiveness Conflict Risk | Deepgram is a specific product/API, and the description targets a narrow use case (hello world / quick start examples). This is unlikely to conflict with other skills unless there are multiple Deepgram-related skills. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
64%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a solid, actionable skill with excellent executable code examples and good error handling guidance. Its main weakness is scope creep — for a 'minimal working example' / 'hello world' skill, it includes too much content (Python equivalents, advanced features, model comparison tables) that inflates token cost and dilutes the core message. Tightening the scope to truly minimal examples and deferring extras to referenced files would improve both conciseness and progressive disclosure.
Suggestions
Trim to a single 'minimal' example (URL transcription in one language) and move Python equivalent, diarization features, and model options table to separate referenced files to match the 'hello world' framing.
Add a quick validation step after prerequisites — e.g., 'Verify setup: run `echo $DEEPGRAM_API_KEY` to confirm the key is set' — to improve workflow clarity.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is mostly efficient with executable code examples, but includes some unnecessary content for Claude — the Python equivalent section adds bulk for a 'hello world' skill, the model options table and resources section add tokens that could be deferred, and Step 4/5 go beyond the stated 'minimal working example' scope. | 2 / 3 |
Actionability | All code examples are fully executable and copy-paste ready with real URLs, specific imports, concrete API calls, and complete function bodies. The error handling table provides specific solutions for specific errors. | 3 / 3 |
Workflow Clarity | Steps are clearly sequenced and labeled, but for a non-destructive API call skill the 'steps' are really independent examples rather than a true workflow. There's no validation checkpoint — e.g., no step to verify the API key works before proceeding, and no explicit check that the SDK installed correctly before running code. | 2 / 3 |
Progressive Disclosure | The skill references next steps (deepgram-core-workflow-a/b) and external resources, which is good. However, the content is somewhat monolithic — the Python equivalent, feature additions, and model options table could be split into separate reference files rather than inlined in what's supposed to be a 'hello world' skill. | 2 / 3 |
Total | 9 / 12 Passed |
Validation
81%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 9 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
allowed_tools_field | 'allowed-tools' contains unusual tool name(s) | Warning |
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 9 / 11 Passed | |
3a2d27d
Table of Contents
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.