Content
67%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, well-sequenced expert workflow with concrete commands, validation checkpoints, and appropriate delegation to external skill protocols. Its main weaknesses are redundancy (repeated safety rules and mandates), a padded persona section, and several markdown formatting glitches that impede readability.
Suggestions
State the 'never run dbt run without confirmation' rule and the mandatory cleaning/optimization requirements once (in Execution Constraints / Operational Rules) instead of repeating them across Steps 3 and 5.
Remove or shrink the 'Role & Persona' section — instructions like 'Be direct, objective, and fact-driven' add tokens without adding capability-specific guidance.
Fix the malformed markdown: the blockquote embedded in Step 4's bullet, the collapsed 'Propose with Confirmation' bullet list, and the wrapped 'References & Sources' table rows.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient directives with no conceptual padding, but it could be tightened: the 'NEVER execute dbt run without explicit user confirmation' rule appears three times, the cleaning/optimization mandate is duplicated between Step 3 and Operational Rules, and the 'Role & Persona' section is padding Claude does not need. | 3 / 5 |
Actionability | Mostly executable guidance with concrete commands (`bq show --schema --format=prettyjson`, `dbt init --skip-profile-setup`, `gcloud config get-value project`), a concrete rewrite table (IN -> EXISTS), working config/YAML examples, and exact confirmation prompts; minor gaps include `gcloud logging read` lacking the actual filter syntax and the absence of a dbt unit-test YAML example. | 4 / 5 |
Workflow Clarity | Steps 0-6 are clearly sequenced with explicit validation (Step 5: compile, test, fix errors) and a feedback loop (Step 6: 'Repeat steps 4-5'), plus a hard safety gate on `dbt run`; minor gaps are the thin Step 4, the hedged 'Run dbt test... if applicable' checkpoint, and inconsistent step header styles. | 4 / 5 |
Progressive Disclosure | Good single-file structure with clear thematic sections and protocols delegated to clearly-named external skills (@skill:data-autocleaning, @skill:developing-with-bigquery) instead of being inlined; however, niche content (BigLake 4-part naming, remote-DAG troubleshooting) sits inline in a ~280-line file and malformed formatting (broken 'Propose with Confirmation' list, mangled References & Sources table) slightly hurts navigation. | 4 / 5 |
Total | 15 / 20 Passed |