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

Quality

91%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

—

The risk profile of this skill

Quality

Content

92%Weight 40%Scale 1-3

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

A tight, highly actionable quickstart with executable code and clear sequencing. The main gap is progressive disclosure: a bundle reference file exists but is not linked from the body.

Suggestions

Add a clearly signaled link to references/extended-examples.md (e.g. under an "Extended examples" section) so the bundle is discoverable.

Consider moving the Step 4 diarization detail and/or the model-options table into the reference file to keep SKILL.md a focused overview.

Dimension	Reasoning	Score
Conciseness	The body is lean executable code and tables with minimal prose and no explanations of concepts Claude already knows; each section earns its place.	3 / 3
Actionability	Provides fully executable TypeScript and Python snippets with real audio URLs, specific model names, exact run commands, and an error-to-solution table — copy-paste ready.	3 / 3
Workflow Clarity	Prerequisites lead into a clearly numbered Step 1–6 sequence with an error-handling table and explicit run commands; no destructive operations require validation checkpoints.	3 / 3
Progressive Disclosure	The body is well-organized but never signals or links the existing references/extended-examples.md file, and diarization/model-option content that could live in a reference stays inline.	2 / 3
	Total	11 / 12 Passed

Description

90%Weight 40%Scale 1-3

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 description that names the domain, gives explicit use-when guidance, and lists natural trigger phrases. Its only weakness is that the capability list is a single action rather than multiple concrete operations.

Suggestions

Broaden the capability statement beyond one action, e.g. "Transcribe audio from a URL or local file and pick the right Deepgram model."

Dimension	Reasoning	Score
Specificity	Names the domain and one concrete action ("Create a minimal working Deepgram transcription example") but does not enumerate multiple specific actions like the score-3 anchor; not vague enough for a 1.	2 / 3
Completeness	Clearly states what it does and includes an explicit "Use when..." clause plus triggers, answering both 'what' and 'when'.	3 / 3
Trigger Term Quality	An explicit "Trigger:" line lists five natural phrases ("deepgram hello world", "deepgram example", "deepgram quick start", "simple transcription", "transcribe audio") a user would actually say.	3 / 3
Distinctiveness Conflict Risk	Deepgram-specific triggers carve out a clear niche unlikely to fire for unrelated speech-to-text or transcription skills.	3 / 3
	Total	11 / 12 Passed

Validation

87%

Warnings & errors only

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

Validation — 14 / 16 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	14 / 16 Passed

Repository: jeremylongshore/claude-code-plugins-plus-skills
Path: plugins/saas-packs/deepgram-pack/skills/deepgram-hello-world/SKILL.md
Commit: 0540a62

Reviewed: about 1 hour ago

Table of Contents

Discovery Implementation Validation

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.