Content
81%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, workflow-driven skill body with exceptional CLI/JSON specificity and strong validation checkpoints. Its main weaknesses are token redundancy (critical rules restated 4-5 times) and inline reference-grade material (palettes, theme mechanics) that inflates the body instead of living in a bundle file.
Suggestions
State the --dataset-catalog/--dataset-schema flag-only rule once in a single canonical callout and reference it from the Quick Reference, Step 5, and Implementation Guidelines instead of repeating it ~5 times.
Move the starter palette block and the palette-design/color-theory rules into a reference file (e.g., a theme reference) and keep only the decision-level guidance inline.
Fix the incomplete sentence in Step 3 ("The datasets.querylines in the dashboard json (see example below) must be tested to ensure") and remove the dangling "(see example below)" pointer.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with genuinely non-obvious specifics (flag-only CLI rules, per-widget versions, JSON gotchas), but the --dataset-catalog/--dataset-schema rule is repeated ~5 times (Quick Reference table, Step 2 note, Step 5 deploy comments, update comments, Implementation Guidelines §1) and the bare-table-name rule 3-4 times. It also explains design knowledge Claude already has ("~4-5% of viewers have color blindness", the 60/30/10 rule, "Don't put red and green adjacent"), so it could be tightened considerably. | 3 / 5 |
Actionability | Fully executable throughout: copy-paste CLI blocks (including DASHBOARD_ID capture via jq and the mkdirs precondition), exact JSON skeletons, correct-vs-wrong field-matching examples, per-widget size tables, and a 13-item pre-deploy checklist. The commands cover all common cases (create, update, publish, trash, schema discovery, parallel multi-query probing). | 5 / 5 |
Workflow Clarity | The NEW DASHBOARD CREATION WORKFLOW is a clearly sequenced 5-step process with explicit validation ("You MUST test ALL SQL queries via CLI BEFORE deploying", "gate on each object's state != \"SUCCEEDED\""), feedback loops ("Fix the query or adjust the story before moving on"), a pre-deploy quality checklist, and lifecycle rules for update→publish. Not 4: explicit checkpoints and error-recovery guidance (exit-code gotcha, 2>&1/jq pitfall) are present at every risky step. | 5 / 5 |
Progressive Disclosure | Navigation is excellent: the Widget Index maps every widget type to a verified anchor in a reference file, the "What are you building?" and Reference Files tables route tasks to files, all 6 bundle reference files are linked, and references are one level deep. Not 5: the ~575-line body inlines reference-grade material (8 starter palettes of hex codes, detailed theme mechanics) that belongs in a reference file, and cross-skill links like ../databricks-metric-views/SKILL.md do not resolve within this bundle. | 4 / 5 |
Total | 17 / 20 Passed |