Content
100%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.
An exemplary conventions body: lean, directive-only, and every rule pinned to a concrete API or module path specific to the Vibe codebase. It contains zero conceptual explanation, zero padding, and no unnecessary structure, scoring at the top of every dimension.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every line is a directive with no padding — e.g. "Never run CPU-heavy or I/O-bound code on the event loop... offload it with asyncio.to_thread" and "Async file wrappers don't make blocking syscalls non-blocking" assume Claude's competence and explain only Vibe-specific constraints. Anchor 5: every token earns its place. | 5 / 5 |
Actionability | Each rule names concrete, executable APIs and paths: "asyncio.create_task + queues", "asyncio.to_thread", "anyio.Path", "VibeAsyncHTTPClient from vibe.utils.http", "respx" for mocking, plus the exact prohibition "do not resolve DNS before proxy selection". For an instruction-only conventions skill this is fully actionable guidance, which the rubric says should not be penalized for lacking code. | 5 / 5 |
Workflow Clarity | This is a single-purpose conventions skill under 50 lines with no multi-step process and no destructive or batch operations, so the simple-skill exception applies: each section's single action is unambiguous. Anchor 5. | 5 / 5 |
Progressive Disclosure | Under 50 lines, needs no external references, and is organized into clear topical sections (Runtime, Blocking work, Streaming, Core-to-client communication, HTTP clients). Per the rubric guideline, a short skill with no need for bundle files scores 5 with well-organized sections; no references/ or scripts/ files exist to reconcile. | 5 / 5 |
Total | 20 / 20 Passed |