Content
35%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.
The body functions as an exhaustive role/catalog definition rather than actionable guidance: it lists many tools Claude already knows, provides only abstract workflow steps, and inlines everything with no progressive disclosure. The main improvements are trimming redundant catalog sections and adding concrete, executable patterns.
Suggestions
Cut the redundant Capabilities/Knowledge Base/Behavioral Traits catalogs that restate technologies Claude already knows; keep only non-obvious guidance, decision rules, and standards specific to your stack.
Replace abstract Instructions/Response Approach steps with concrete, executable patterns (e.g., example dbt project structure, Airflow DAG skeleton, a Great Expectations validation suite snippet, CDC config).
Add explicit validation checkpoints and error-recovery loops in the pipeline workflow (e.g., validate schema -> run quality checks -> only then write to production sink -> alert on failure), since this skill covers batch and production writes.
Move the long cloud-platform capability lists into reference files (e.g., references/aws-stack.md) referenced one level deep from SKILL.md, so the overview stays lean.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The 215-line body is a padded catalog restating technologies Claude already knows (Snowflake, BigQuery, Kafka, Spark, etc.) across redundant sections (Capabilities, Knowledge Base, Behavioral Traits) that add little beyond the description. | 2 / 5 |
Actionability | Guidance is high-level and abstract ('Define sources, SLAs, and data contracts', 'Analyze data requirements for scale, latency, and consistency needs') with no concrete code, commands, templates, or specific executable procedures. | 2 / 5 |
Workflow Clarity | A rough sequence exists (Instructions 1-4 and Response Approach 1-8), and the Safety section notes to 'Validate data before writing to production sinks', but explicit validation checkpoints and error-recovery feedback loops are otherwise absent for batch/production operations. | 3 / 5 |
Progressive Disclosure | Section headers provide some structure, but the entire capability catalog (cloud stacks, tool lists) is inlined in one file with no bundle references, so content that could live in separate files is all inline. | 3 / 5 |
Total | 10 / 20 Passed |