CtrlK
BlogDocsLog inGet started
Tessl Logo

deepgram-rate-limits

Implement Deepgram rate limiting and backoff strategies. Use when handling API quotas, implementing request throttling, or dealing with 429 rate limit errors. Trigger: "deepgram rate limit", "deepgram throttling", "429 error deepgram", "deepgram quota", "deepgram backoff", "deepgram concurrency".

67

Quality

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Content

65%

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

The content is highly actionable with executable TypeScript for every component and a clear step sequence, but it is held back by verbosity from duplicating the reference file inline and by the absence of explicit validation checkpoints for a batch workflow. The bundle file exists but is unused, leaving progressive disclosure underdeveloped.

Suggestions

Move the full component implementations into references/implementation.md and replace the inline code in SKILL.md with concise overview snippets plus clearly signaled links to the reference, eliminating the duplication.

Add an explicit validation/feedback checkpoint to the batch workflow (e.g. inspect Promise.allSettled rejections, back off on 429s, and retry failed items) so the sequence earns full workflow-clarity credit.

Link references/implementation.md from a well-signaled section in the body (e.g. '## Implementation details: See [implementation.md](references/implementation.md)') so the bundle file is discoverable.

DimensionReasoningScore

Conciseness

The body is mostly executable code with lean comments, but it inlines five full implementations (rate limiter, backoff, circuit breaker, combined client, usage monitor) that substantially duplicate the code already present in references/implementation.md, plus light filler such as 'Understanding this model is key to building reliable integrations.' It is not level 3 because the duplication and extra commentary mean not every token earns its place, and not level 1 because the bulk is concrete code rather than padded concept explanation.

2 / 3

Actionability

Provides fully executable, copy-paste-ready TypeScript for each component with concrete usage examples (e.g. Promise.allSettled over hundreds of urls, production usage of ResilientDeepgramClient). Matches the level-3 anchor of fully executable code with specific examples.

3 / 3

Workflow Clarity

Steps 1 through 5 are clearly sequenced and an error-handling table is provided, but the workflow is a batch operation (transcribing hundreds of URLs) with no explicit validation/verification checkpoints or a validate-fix-retry feedback loop in the step sequence. Per the rubric guidance for batch operations, missing validation caps this at level 2; it is above level 1 because the sequence is explicit.

2 / 3

Progressive Disclosure

A bundle file references/implementation.md exists, but it is never referenced or signaled from the body (the Resources section links only to external URLs), and content that belongs in the reference is instead inlined in SKILL.md. This matches the level-2 anchor of references present but not clearly signaled with content that should be separate left inline; it is not level 1 because the body sections are well organized rather than a monolithic wall.

2 / 3

Total

9

/

12

Passed

Description

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.

The description is specific, complete, and distinctive, naming concrete actions, an explicit Use-when clause, and a set of natural trigger terms all scoped to Deepgram. It is concise and free of vague fluff or over-claims.

DimensionReasoningScore

Specificity

Lists multiple concrete actions such as 'Implement Deepgram rate limiting and backoff strategies', 'handling API quotas', 'implementing request throttling', and 'dealing with 429 rate limit errors'. This matches the level-3 anchor of multiple specific concrete actions rather than the level-2 single-domain listing.

3 / 3

Completeness

Clearly answers both what (implement rate limiting and backoff) and when (an explicit 'Use when handling API quotas, implementing request throttling, or dealing with 429 rate limit errors' clause plus a Trigger line). Matches the level-3 anchor answering both what and when with explicit triggers; it is not level 2 because the when guidance is explicit, not implied.

3 / 3

Trigger Term Quality

Includes an explicit Trigger line with natural terms a user would say: 'deepgram rate limit', 'deepgram throttling', '429 error deepgram', 'deepgram quota', 'deepgram backoff', 'deepgram concurrency'. Good coverage of natural variations, matching the level-3 anchor.

3 / 3

Distinctiveness Conflict Risk

Scoped to a clear niche (Deepgram) with distinct 'deepgram'-prefixed trigger terms, making it unlikely to fire for unrelated skills. Matches the level-3 anchor of a clear niche with distinct triggers.

3 / 3

Total

12

/

12

Passed

Validation

87%

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

Validation14 / 16 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

14

/

16

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.