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 instruction-only skill body: it is lean, teaches only what Claude could not already know, gives paste-ready examples for every common case, and closes with a validation-anchored checklist. The single reference file is well-signaled and appropriately scoped, leaving nothing material to improve.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with only novel, proprietary information (Comark syntax, query pipeline grammar, error codes) and assumes Claude's competence — e.g., it never explains what Markdown or a table is. Every section earns its tokens; no padded or generic passages are present, matching the 'lean and efficient' anchor. | 5 / 5 |
Actionability | Guidance is fully executable: copy-paste-ready component blocks (`::bm-bars{title="Throughput" ...}` with row grammar), a decision table mapping intent to component names, concrete query pipelines (`notes | where type == decision ... | count`), and an error-code table with a specific fix per code. Per the rubric's instruction-only provision, the absence of script code is not penalized since every example can be pasted directly into a note. | 5 / 5 |
Workflow Clarity | Sections follow the working order (pick → write → live views → edit → errors) with explicit validation checkpoints and feedback loops: 'Read it back after writing a live view and confirm the view has rows before you state a number in prose', error problems that 'never block the write' with instruction to 'fix them right away with edit_note', and a final five-item numbered checklist. This matches the anchor requiring explicit validation, error-recovery loops, and a checklist. | 5 / 5 |
Progressive Disclosure | The body keeps only the 13 most-needed components inline and delegates the full vocabulary ('The full vocabulary, every prop, and every data grammar are in [references/components.md](references/components.md). Read it before using a component you have not used before') to a single, clearly signaled, one-level-deep reference that exists on disk (740 lines). Navigation is easy and the split is appropriate, matching the anchor-5 structure. | 5 / 5 |
Total | 20 / 20 Passed |