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.
A tight, single-purpose skill body: concrete file format, unambiguous workflows with validation and fallback branches, and disciplined sectioning. Its only flaw is mild repetition of the re-read-freshly instruction across three sections.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with non-obvious, skill-specific facts (the `current.json` schema, 0-based `pageIndex` vs 1-based `pageNumber`, selection line/column semantics, staleness tiers) and assumes Claude's competence throughout. However, the re-read-freshly imperative is repeated across the intro, the dedicated 'Re-read on every deictic turn' section, and again inside 'Staleness', so a few sentences could be trimmed — matching 'efficient; minor instances of over-explanation that could be trimmed' rather than the lean-every-token-earns-its-place anchor. | 4 / 5 |
Actionability | Everything is executable: the exact path `node_modules/.open-slide/current.json`, a full annotated JSON payload, field-by-field usage instructions, concrete staleness thresholds (~5 minutes), fallback prompts to ask the user verbatim, and two copy-paste-ready numbered workflows including the preview URL `s/<slideId>/preview?p=<pageNumber>`. This matches the fully-executable anchor with common cases covered. | 5 / 5 |
Workflow Clarity | Both example workflows are clearly sequenced with explicit validation checkpoints — 'Check `updatedAt` is recent', confirming the element via `selection.text` and `tagName` — plus error-recovery branches (stale → confirm with user; missing file → ask; `selection` null → page-level fallback). This matches the top anchor for clear sequence with explicit validation and feedback paths; the skill involves no destructive or batch operations that would require additional loops. | 5 / 5 |
Progressive Disclosure | The skill has no bundle files, and nothing in the body warrants splitting — every section is core to the single task. Content is well-organized under clear headers with a clean overview-to-detail flow, and the two outward references (the `slide-authoring` skill and its preview section) are well-signaled and exactly one level deep, so there is no burying or nesting. This matches the well-organized, easy-navigation anchor. | 5 / 5 |
Total | 19 / 20 Passed |