Content
25%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill is essentially a hollow shell — it provides a high-level outline of data quality concepts but offers zero concrete, actionable guidance. There are no code examples, no configuration templates, no specific commands for Great Expectations or dbt, and no executable workflows. The entire substance is deferred to a referenced playbook file that doesn't exist in the bundle, making the skill nearly useless in practice.
Suggestions
Add concrete, executable code examples for at least one framework (e.g., a Great Expectations checkpoint configuration, a dbt test YAML, or a data contract schema definition) directly in the SKILL.md.
Replace the abstract instruction bullets with a specific multi-step workflow including validation checkpoints, e.g., '1. Create expectation suite: `great_expectations suite new ...` 2. Run validation: `great_expectations checkpoint run ...` 3. Check results and fix failures before proceeding.'
Either provide the referenced `resources/implementation-playbook.md` bundle file or inline the essential patterns and templates so the skill is self-contained enough to be useful.
Add at least one complete input/output example showing what a data quality check looks like in practice (e.g., a dbt test YAML file with expected pass/fail behavior).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is relatively short but includes some unnecessary sections like 'Use this skill when' and 'Do not use this skill when' that are somewhat obvious and don't add much value. The instructions themselves are extremely terse to the point of being unhelpful, but the overall file isn't padded with explanations of concepts Claude already knows. | 3 / 5 |
Actionability | The instructions are entirely vague and abstract — 'Identify critical datasets,' 'Define expectations/tests,' 'Automate validation in CI/CD' — with zero concrete code, commands, configuration examples, or specific steps. There is no executable guidance whatsoever; it reads like a high-level checklist of goals rather than actionable instructions. | 1 / 5 |
Workflow Clarity | There is a rough sequence implied (identify → define → automate → alert), but steps are poorly defined with no specifics, no validation checkpoints, and no feedback loops. For a skill involving data quality validation pipelines (which are multi-step and can involve destructive/batch operations), the lack of any concrete workflow or validation steps is a significant gap. | 2 / 5 |
Progressive Disclosure | The skill references `resources/implementation-playbook.md` for detailed content, which is a reasonable structure, but no bundle files are provided so the reference is unverifiable and potentially broken. The SKILL.md itself contains almost no substantive content — it defers nearly everything to the playbook without providing even minimal inline examples or quick-start guidance. | 2 / 5 |
Total | 8 / 20 Passed |