Content
92%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 body is a lean, opinionated architecture guide: dense with non-obvious rules, a clear pre-code-to-verification workflow with explicit checkpoints, and proper progressive disclosure to a real reference file and well-mapped sibling skills. Its only gap is the absence of any code, which it justifies by explicitly delegating API specifics to a companion skill.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is almost entirely non-generic guidance — "Never classify intent with code", "omission preserves; missing, empty, unknown, and cleared are four different things", "If you can't say in one sentence what an agent is responsible for, split it" — with no explanation of concepts Claude already knows and no padding. Not a 4 because there is no section that reads as trimmable over-explanation; even the OSS/Cloud paragraph resolves a real ambiguity. | 5 / 5 |
Actionability | Concrete directive guidance throughout: named env vars ("LIVEKIT_URL, LIVEKIT_API_KEY, LIVEKIT_API_SECRET"), a numbered pre-code checklist, and specific rules like "Validate *structure* in code (typed dates, enums, required fields); leave *meaning* to the model". Not a 5 because, as an instruction-only skill, it contains no executable code or commands — though it deliberately and explicitly delegates API specifics to reading-livekit-docs, which the rubric's scoring note partially excuses. Not a 3 because the guidance is concrete and executable in its decisions, not pseudocode-level hints. | 4 / 5 |
Workflow Clarity | A clear sequence with explicit validation checkpoints: "Before you write code" (load docs, confirm credentials, decide structure, plan verification), then "Start with a failing complete-path test" with a guard-pairing feedback loop ("a test that rejects everything proves nothing about the guard"; "Keep that pair green while you add everything else"), and staged verification tiers (while building / before done / before shipping). Not a 4 because checkpoints are explicit at every stage rather than having minor gaps. | 5 / 5 |
Progressive Disclosure | SKILL.md is a well-organized overview with one clearly signaled, one-level-deep reference — "The full treatment... is in `references/state-and-effects.md`. Read it before building anything that books, edits, confirms, or ends calls" — and the file exists in the bundle with substantive content (134 lines). A "Related skills" section maps each sibling skill to its role. Not a 4 because navigation is unambiguous and the split (overview here, deep treatment in the reference) is exactly appropriate. | 5 / 5 |
Total | 19 / 20 Passed |