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.
An excellent hub document for a large 34-file bundle: concrete commands and APIs throughout, clearly sequenced workflows with validation checkpoints and destructive-operation gating, and a clean progressive-disclosure structure where every reference path was verified to exist. The only weakness is minor conciseness redundancy where a few rules are stated in two or three places.
Suggestions
Consolidate the CREATE OR REFRESH guidance: it appears both as a Common Trap ("'CREATE OR REFRESH' vs 'CREATE'") and as the first row of the Common Issues table — keep one and cross-link the other.
Trim one of the three statements of the UNION/Append-Flow rule (decision tree, Common Traps, and the Flow and Sink API table) to a single canonical location with cross-references.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with non-obvious, high-value specifics (error-to-fix mappings, version gates like "DBR 18.3+", exact decorators and SQL forms) and assumes Claude's competence — no concept padding like "what is streaming". It sits at anchor 4 rather than 5 because of minor trimmable redundancy: the CREATE OR REFRESH convention appears in both Common Traps and the Common Issues table, and the UNION/Append-Flow point is made three times (decision tree, traps, API table). | 4 / 5 |
Actionability | Fully executable, copy-paste-ready guidance throughout: exact CLI commands ("databricks pipelines init --output-dir . --config-file init-config.json", "databricks bundle deploy -t dev --profile <profile>"), exact API names ("@dp.append_flow(once=True)", "dp.create_auto_cdc_from_snapshot_flow()"), exact SQL ("AUTO CDC INTO ... FROM STREAM"), and exact error keys ("__START_AT"/"__END_AT", "error.exceptions[0].message"). This matches the anchor-5 example of specific commands covering the common cases with no gaps. | 5 / 5 |
Workflow Clarity | Sequences are explicit and gated: pick language → choose workflow (A/B/C with defaults) → scaffold → validate → deploy → run → poll that update, with explicit validation steps ("databricks bundle validate", DESCRIBE-before-submit for cluster keys, "Always poll the update, not top-level pipeline state"), error-recovery feedback loops (Common Issues table plus jq error-extraction pointer), and an approval gate on the destructive full-refresh option. The batch/destructive cap at 3 does not apply since validation is present; this fits the anchor-5 checklist-and-recovery pattern. | 5 / 5 |
Progressive Disclosure | A hub-and-reference design executed well: the SKILL.md body holds only routing/decision knowledge and an API index whose every row links the exact (feature, language) reference file; all 34 bundle files exist and are reachable (verified — python-basics.md and sql-basics.md are linked from sibling references rather than orphaned); referenced anchors resolve (e.g., performance.md "### Cluster key data types"); and references are one level deep with a grouped Reference Index. This matches anchor 5 (clear overview, well-signaled one-level-deep references, easy navigation). | 5 / 5 |
Total | 19 / 20 Passed |