Content
82%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The content is a strong, lean SDK-oriented skill: fully executable quick start, precise API surface mapping to repo source files, and a gotchas section capturing real failure modes. Its only real weaknesses are mild — a slightly padded reference/promotion tail, an implicit rather than explicit validate-recover loop, and inlined detail that could live in a reference file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with non-obvious, SDK-specific facts (connect args, socket methods, gotchas like "Close with `sendCloseStream`, not `sendFinalize`") and never explains concepts Claude already knows, matching the lean anchor. It falls short of 5 because the five-layered "API reference" section and the closing "Central product skills" promotion ("npx skills add deepgram/skills") include tokens that could be trimmed without losing guidance value. | 4 / 5 |
Actionability | The quick start is copy-paste-ready executable code drawn from a real repo example (`examples/26-transcription-live-websocket-v2.ts`), with concrete auth setup, exact socket methods (`sendMedia`, `sendCloseStream`, `waitForOpen`), exact repo source paths for the API surface, and a runnable install command. This fully matches the anchor for executable guidance covering the common cases. | 5 / 5 |
Workflow Clarity | The connection sequence is clear and even called out explicitly ("`createConnection()` is lazy. Call `connect()` after registering handlers"), and error handling appears via the `FatalError` handler and the 400/access diagnosis gotcha. It is not 5 because the workflow lives implicitly in code order rather than an explicit validate/recover loop, and not 3 because most checkpoints (wait for open, FatalError close, endpoint-availability diagnosis) are present. | 4 / 5 |
Progressive Disclosure | The body is well-sectioned and pushes detail to clearly signaled, one-level-deep sources — in-repo files (`src/CustomClient.ts`, `src/api/.../{Client,Socket}.ts`), the canonical OpenAPI/AsyncAPI URLs, and product docs. It falls short of 5 because no bundle reference files exist (no `references/`, `scripts/`, or `assets/`), so moderately deep material like the parameter list and gotcha details is inlined in SKILL.md rather than split out. | 4 / 5 |
Total | 17 / 20 Passed |