Content
65%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
Highly actionable with concrete executable code and a clear sequenced checklist, but held back by length that should live in (missing) reference files and by broken references to a non-existent reference/cosmos-config.md.
Suggestions
Create the referenced reference/cosmos-config.md (or remove the broken "See reference/cosmos-config.md" links) so the signaled progressive disclosure is real and the per-mode ProfileConfig/operator_args detail can move out of SKILL.md.
Add mid-process validation checkpoints with fix-and-retry guidance (e.g., confirm the manifest loads and the warehouse connection resolves before assembling the full DAG), not just the final §8 checklist, to satisfy the feedback-loop expectation for dbt/database operations.
Trim §7's three full DAG examples and Appendix B operational extras to a single canonical pattern, offloading variants to reference files, to improve token efficiency.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~450-line body is mostly efficient (dense tables, no basic-concept explanations) but includes multiple full code examples (three DAG assemblies in §7) and operational appendices that could be tightened or moved to reference files; not every token earns its place. | 2 / 3 |
Actionability | Concrete, executable Python with imports throughout (ProjectConfig, RenderConfig, DbtDag, DbtTaskGroup, operators) plus when-to-use tables make the guidance copy-paste ready. | 3 / 3 |
Workflow Clarity | There is a clear numbered sequence (§1–§8), a pre-flight confirmation, and a final §8 safety checklist, but no mid-process validate→fix→retry feedback loops; for dbt (database) operations the missing feedback loops cap this at 2 per the rubric notes. | 2 / 3 |
Progressive Disclosure | The body repeatedly signals "See reference/cosmos-config.md" (§3, §4, §5, §6), but no references/ directory or cosmos-config.md exists, so the links are broken and the detail stays inline; sections are well organized but the file split is not actually realized. | 2 / 3 |
Total | 9 / 12 Passed |