CtrlK
BlogDocsLog inGet started
Tessl Logo

deepgram-js-management-api

Use when writing or reviewing JavaScript/TypeScript in this repo that calls Deepgram Management APIs for projects, API keys, members, invites, requests, usage, billing, models, and agent think-model discovery. Covers `client.manage.v1.*` plus `client.agent.v1.settings.think.models.list()`. Use `deepgram-js-voice-agent` when you want to run an agent live rather than administer projects or inspect models. Triggers include "management API", "list projects", "API keys", "members", "invites", "usage stats", "billing", "list models", and "manage.v1".

87

1.30x
Quality

82%

Does it follow best practices?

Impact

91%

1.30x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

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 hits all the marks. It provides specific concrete actions, comprehensive trigger terms, explicit 'Use when' and disambiguation guidance, and a clear niche that distinguishes it from related skills. The inclusion of exact API paths and a pointer to the related voice-agent skill is particularly well done.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: calling Deepgram Management APIs for projects, API keys, members, invites, requests, usage, billing, models, and agent think-model discovery. Also specifies exact API paths like `client.manage.v1.*` and `client.agent.v1.settings.think.models.list()`.

3 / 3

Completeness

Clearly answers both 'what' (writing/reviewing JS/TS code calling Deepgram Management APIs for specific resources) and 'when' (explicit 'Use when' clause at the start, plus explicit trigger terms listed at the end). Also includes a disambiguation clause pointing to a different skill for live agent use.

3 / 3

Trigger Term Quality

Excellent coverage of natural trigger terms users would say: 'management API', 'list projects', 'API keys', 'members', 'invites', 'usage stats', 'billing', 'list models', 'manage.v1'. These are terms a developer would naturally use when working with Deepgram management functionality.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive with a clear niche (Deepgram Management APIs specifically), and explicitly disambiguates from a related skill (`deepgram-js-voice-agent`) for live agent scenarios. The specific API paths and trigger terms make it very unlikely to conflict with other skills.

3 / 3

Total

12

/

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 that covers a broad API surface with executable code examples and useful gotchas. Its main weaknesses are the lack of validation/feedback loops for destructive operations and some verbosity in reference sections. The content would benefit from explicit safety workflows around delete/leave operations and tighter organization of the API surface catalog.

Suggestions

Add explicit validation/confirmation steps for destructive operations (delete project, remove member, delete key) — e.g., 'verify project exists before deleting, check response status, confirm deletion'.

Consider moving the full API surface listing and external reference URLs into a separate REFERENCE.md to keep SKILL.md focused on quick-start patterns and gotchas.

DimensionReasoningScore

Conciseness

Generally efficient but includes some sections that could be tightened — the 'When to use this product' bullet list partially restates the description, the 'API reference (layered)' section is lengthy with external URLs that may go stale, and the 'Central product skills' section at the end adds promotional content. However, most code examples are lean and the gotchas section earns its tokens.

2 / 3

Actionability

Provides fully executable, copy-paste-ready code examples for authentication, project listing, key/member/invite/usage/billing operations, and think-model discovery. The API surface section gives concrete method paths, and the gotchas section includes specific details like the nested key ID path `keys.api_keys[0].api_key.api_key_id`.

3 / 3

Workflow Clarity

The skill covers many API endpoints but presents them as flat listings rather than sequenced workflows. For destructive operations (delete, leave, key deletion), gotcha #4 warns they're dangerous but provides no validation checkpoints or confirmation steps. The absence of feedback loops for these destructive operations caps this at 2.

2 / 3

Progressive Disclosure

References to example files and external docs are well-signaled, and the layered API reference section is a good pattern. However, with no bundle files provided, the references to `reference.md` and the 11 example files cannot be verified. The inline content is moderately long (~130 lines) and the full API surface listing could potentially be offloaded to a reference file.

2 / 3

Total

9

/

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
deepgram/deepgram-js-sdk
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.