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 lean, well-structured guidelines body that puts only decision rules inline and delegates examples and detail to a single clearly-signaled reference. The only gap is the absence of a minimal complete grid YAML example in the body itself.
Suggestions
Add one minimal copy-paste-ready grid YAML example (a page Grid with a couple of components and -1 empty cells) to the Core Rules section so the common case is executable without loading the reference.
Show the exact form of 'just provide the column name to Filter' with a one-line YAML snippet in the Selectors section to make the default-selector rule fully executable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every line is Vizro-specific constraint or judgment guidance (e.g. 'Use `-1` for empty cells', 'Charts need at least 2–3 rows to avoid looking squeezed'); nothing re-explains concepts Claude already knows and no section is padded. | 5 / 5 |
Actionability | Highly concrete guidance — 12 columns, 140px rows, a component sizing table, and a data-type-to-selector mapping with examples — but no complete grid YAML snippet in the body; the executable examples live only in the reference file, a minor gap. | 4 / 5 |
Workflow Clarity | Qualifies for the simple-skill exception (under 50 lines, single task): applying the layout constraints is unambiguous, and the 'Modifying existing layouts' rule gives a clear conditional branch. No destructive or batch operations, so no validation cap applies. | 5 / 5 |
Progressive Disclosure | Core rules are inline with details split into references/layout-guidelines.md (verified to exist), linked three times with correct one-level-deep paths, and the 'Deep Dive' section enumerates exactly what the reference contains. | 5 / 5 |
Total | 19 / 20 Passed |