Content
85%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.
Excellent actionable content: the 7-step workflow is fully executable with explicit validation gates, feedback loops, and real one-level-deep references. The only weakness is repetition — the 'trust Fusion's errors, don't pre-fix' principle is stated many times over, which could be consolidated.
Suggestions
Consolidate the 'trust Fusion's error output / don't pre-fix what Fusion hasn't flagged' guidance, which currently appears in the intro, Step 5, its own 'Trust Fusion's errors' paragraph, Don'ts #1-#2, and the Limitations section, into one authoritative statement (e.g., a single callout in Step 5).
Remove the Contents section or merge it with the Additional Resources list, since they duplicate each other's entries and anchors.
Trim restated validation criteria (0 errors/0 warnings) by referencing the single 'Success criteria' definition from the checklist and Step 7 rather than repeating the threshold inline in Step 5 and elsewhere.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with non-obvious specifics (warning codes like dbt1065/dbt1005, cache clearing, versioned-model caveats) but the 'trust Fusion's errors / don't pre-fix' principle is restated roughly six times across the intro, Step 5, the 'Trust Fusion's errors' paragraph, the Don'ts, and Limitations, and the Contents section duplicates the Additional Resources list. This is noticeable tightening opportunity beyond the 'minor instances' of anchor 4, fitting anchor 3. | 3 / 5 |
Actionability | Fully executable guidance throughout: concrete commands ('dbtf compile', 'dbt ls --select "+tag:core" --resource-type model', 'dbt show --select model_name --limit 5', 'rm -rf target/', 'dbt test --select test_type:unit'), coded warnings with specific fixes (dbt1065 → 'cast(sum(col) as decimal(18,2))'), and a copy-paste migration_changes.md template, matching anchor 5. | 5 / 5 |
Workflow Clarity | A 7-step workflow with a copyable progress checklist, explicit validation gates at each phase (0 errors on source, unit tests pass before switching targets, 0 errors AND 0 warnings on target), and iterative fix-recompile-retest feedback loops including error-recovery guidance for failed unit tests — matching anchor 5. | 5 / 5 |
Progressive Disclosure | A clear overview with three well-signaled, one-level-deep reference files (references/installing-dbt-fusion.md, references/generating-unit-tests.md, references/switching-targets.md), all of which exist on disk. Content is appropriately split — installation, test-generation detail, and target-switching detail live in references while the workflow stays in SKILL.md, matching anchor 5. | 5 / 5 |
Total | 18 / 20 Passed |