Content
86%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, high-signal reference skill: lean gotchas, correct snippets, and well-structured one-level-deep disclosure into a real reference file. The only gaps are that code examples are fragments rather than a complete runnable config, and there is no explicit verification step after assembling a configuration.
Suggestions
Add one complete minimal end-to-end YAML example (page → components → controls) to Quick Patterns so users have a fully copy-paste-runnable starting config.
Add a short verification step (e.g., how to launch the app and confirm charts render non-blank) to catch the blank-chart failure mode the mistake list warns about.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every line is a Vizro-specific gotcha, pattern, or import — no explanations of concepts Claude already knows, no padding. The body assumes competence and each token carries Vizro-irreversible information, matching the lean-and-efficient anchor. | 5 / 5 |
Actionability | Concrete directives ("use `data_frame` directly; never re-lookup via `data_manager[data_frame]`") and accurate YAML/Python snippets cover the common component types, but the Quick Patterns are fragments without a complete end-to-end config (no page/dashboard wrapper), so they are not fully copy-paste runnable. Fits mostly-executable-with-minor-gaps rather than the fully-executable anchor. | 4 / 5 |
Workflow Clarity | Clear organization (mistakes → patterns → imports → deep-dive lookup table) gives an unambiguous usage flow, and the Deep Dive table maps needs to specific reference sections. No explicit sequence or verification checkpoint for assembling/validating a config exists, keeping it below the explicit-validation anchor; no destructive or batch operations trigger the cap. | 4 / 5 |
Progressive Disclosure | The body is a genuine overview with details split into a single one-level-deep reference (references/yaml-reference.md, verified to exist with all mapped section headers), clearly signaled twice and navigable via a need-to-search-string table. Matches the clear-overview, well-signaled one-level-deep anchor. | 5 / 5 |
Total | 18 / 20 Passed |