CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

deepgram-go-management-api

Use when writing or reviewing Go code in this repo that works with Deepgram management endpoints for projects, keys, members, scopes, invitations, usage, balances, models, reusable agent configurations, or agent variables. Route live voice runtime to deepgram-go-voice-agent and repo workflow questions 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

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

Highly actionable reference skill with an executable quick start and unusually valuable non-obvious gotchas, but it duplicates the description in the body, inlines an API catalog that belongs in a separate reference file, and offers no verification guidance around destructive admin operations.

Suggestions

Add a brief verification step before destructive calls (e.g., 'before DeleteKey/DeleteProject, List the resources and confirm the target ID with the user') to satisfy the workflow-clarity cap on destructive operations.

Drop or compress the 'When to use this product' bullet list — it repeats the frontmatter description verbatim and saves ~10 lines of token budget.

Move the exhaustive per-resource method catalog out of 'Key parameters' into a reference file (e.g., references/api-methods.md) and keep only the constructor pattern and escape hatch inline.

DimensionReasoningScore

Conciseness

The body is efficient — no explanations of Go or REST basics, a complete compact quick start, and dense high-value gotchas (the agent-variables spec discrepancy). It falls short of 5 because the 'When to use this product' bullet list repeats the frontmatter description almost verbatim, and the exhaustive method-name catalog under 'Key parameters' largely duplicates the in-repo file list in the 'API reference' section.

4 / 5

Actionability

The quick start is copy-paste ready with real import paths, a runnable main, and error handling; authentication is a concrete `export DEEPGRAM_API_KEY=...` command; constructors, exact method names, and the `managev1.Client.APIRequest(...)` escape hatch are all directly usable. Nothing is pseudocode or abstract.

5 / 5

Workflow Clarity

The sequence (set API key → construct client → `api.New(client)` → call helpers → `APIRequest` fallback) is present and coherent, but there are no validation or verification checkpoints anywhere. The skill documents destructive admin operations (`DeleteProject`, `DeleteKey`, `RemoveMember`, `DeleteInvitation`) with no guidance to verify the target (e.g., list/confirm the resource before deleting), which caps this at 3 per the destructive-operations rule.

3 / 5

Progressive Disclosure

Sections are well organized and the layered 'API reference' points one level deep to real repo files and external specs; the skill ships no bundle files, so the body itself is the overview. It is not a 5 because the ~40-line method catalog under 'Key parameters' is inline content that would more properly live in a reference file, and there is no bundle to hold it.

4 / 5

Total

16

/

20

Passed

Description

87%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 description: explicit use-when trigger, concrete domain enumeration, and explicit routing to sibling skills. The only gaps are limited action verbs and a few missing synonyms (admin/account/billing).

DimensionReasoningScore

Specificity

The description enumerates ten concrete management-resource areas ("projects, keys, members, scopes, invitations, usage, balances, models, reusable agent configurations, or agent variables") and pins the domain ("Go code in this repo", "Deepgram management endpoints"), matching the 'several specific actions; minor gaps' anchor. It falls short of 5 because the only action verbs are the generic 'writing or reviewing' — the concrete actions per resource (create/list/delete keys, fetch usage) are left implicit.

4 / 5

Completeness

It explicitly answers both: what ("works with Deepgram management endpoints for projects, keys, members, scopes, invitations, usage, balances, models, reusable agent configurations, or agent variables") and when ("Use when writing or reviewing Go code in this repo that works with Deepgram management endpoints"). Both what and when are explicit and concrete, matching the top anchor; it is not a 4 because the 'when' clause is already fully explicit, not merely improvable.

5 / 5

Trigger Term Quality

Phrases like 'Go code', 'API keys', 'projects', 'usage', 'invitations', 'members' are natural terms a user would say when needing this skill, giving good keyword coverage. It misses common synonyms such as 'admin API', 'account', or 'billing' (for balances), so it does not reach the comprehensive synonym coverage of a 5.

4 / 5

Distinctiveness Conflict Risk

It carves a clear niche (repo-scoped Deepgram management API in Go) and actively reduces conflict risk by routing adjacent work to named siblings: "Route live voice runtime to deepgram-go-voice-agent and repo workflow questions to deepgram-go-maintaining-sdk." This explicit disambiguation makes wrong-skill triggering minimal.

5 / 5

Total

18

/

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-management-api/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.