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.
A highly actionable, syntax-dense skill body that earns its length: every example is executable and the gotchas (filter expression strings, groupBy placement, rows. prefix, file.mtime date math) are exactly what Claude wouldn't know. Weaknesses are moderate: repeated boilerplate across the Bases examples, a step-numbering gap (Steps 1-2 never labeled), and a monolithic structure with no bundle files for the reference tables.
Suggestions
Consolidate the repeated properties:/order: boilerplate across the seven .base examples — show the full skeleton once, then only the differing filter/view block per pattern, trimming ~60 lines.
Fix the step numbering: label the tool-selection/query-drafting phases as Steps 1-2 so 'Step 3: Write the File' doesn't appear without predecessors, or drop numeric step labels entirely.
Move the filter-expression reference table and Dataview clause reference into a references/ file (e.g. references/bases-syntax.md, references/dataview-syntax.md) to shorten SKILL.md to an overview plus core recipes.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and factual with no filler explanations of concepts Claude already knows — Bases .base syntax and Dataview gotchas are genuinely novel information, and the property-conventions/filter-reference/recipes tables are token-efficient. It stops short of anchor 5 because the seven near-identical .base examples each repeat ~10 lines of properties/order boilerplate that could be consolidated. Not anchor 3, since the repetition serves distinct copy-paste recipes rather than unnecessary explanation. | 4 / 5 |
Actionability | Fully executable, copy-paste-ready YAML and Dataview blocks covering the common cases (folder/tag/OR/multi-filters, cards, groupBy, formulas, stale pages, multi-folder), plus concrete target paths, slug examples, an exact log-line format, embed syntax, and qmd commands. Matches anchor 5's 'specific examples cover the common cases'. | 5 / 5 |
Workflow Clarity | Clear overall sequence (resolve config → inspect index.md → choose tool → write file → optional embed → log → QMD refresh) with a quality checklist, an ask-before-modifying guard, and QMD failure handling ('do not roll back the vault changes; report the QMD status separately'). It misses anchor 5 because the numbered steps jump: headers read 'Step 3: Write the File' onward with no Steps 1-2 labeled, leaving the early sequence implicit. | 4 / 5 |
Progressive Disclosure | Good section structure (Option A/B, canonical schema, per-pattern subsections, recipes table, checklist, QMD) and clearly signaled one-level external references to llm-wiki/SKILL.md; there are no nested or buried references. Not anchor 5: at ~470 lines with no bundle files, content like the full filter-expression and Dataview reference tables could live in a references/ file, and the simple-skill exception (under 50 lines) does not apply. | 4 / 5 |
Total | 17 / 20 Passed |