CtrlK
BlogDocsLog inGet started
Tessl Logo

deepgram-hello-world

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

Quality

77%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./plugins/saas-packs/deepgram-pack/skills/deepgram-hello-world/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

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.'

DimensionReasoningScore

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.

DimensionReasoningScore

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.

Validation9 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

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

Repository
jeremylongshore/claude-code-plugins-plus-skills
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.