Content
63%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 skill delivers actionable profiling guidance with specific thresholds and executable SQL inside a clear 7-step workflow, but it is a monolithic 320-line document. Secondary reference material is inlined instead of split into references/ files, textbook statistical concepts pad the token budget, and the one external reference is a broken path.
Suggestions
Move the Quality Assessment Framework, Pattern Discovery Techniques, and Schema Understanding/Documentation sections into references/ files (e.g. references/quality.md, references/schema-docs.md), keeping SKILL.md as a lean workflow overview with clearly signaled one-level-deep links.
Trim or delete concept definitions Claude already knows (distribution shapes like normal/skewed/bimodal, trend/seasonality glossary, "correlation does not imply causation") and de-duplicate the placeholder-value list that appears in both step 4 and the Accuracy Indicators section.
Fix or remove the broken ../../CONNECTORS.md link, or replace it with a short inline note about checking connected tools.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The 7-step workflow is directive and efficient, but the back half pads with textbook statistics Claude already knows ("Skewed right: Long tail of high values", "Bimodal: Two peaks (suggests two distinct populations)", "Correlation does not imply causation") and repeats material (the placeholder-value list "999999", "N/A", "TBD", "test" appears in both step 4 and Accuracy Indicators). Mostly efficient overall, so above the verbose anchor 2 but not the lean anchor 4. | 3 / 5 |
Actionability | Concrete, executable guidance dominates: specific thresholds (>5% warn / >20% alert nulls, |r| > 0.7 correlation flag, cardinality 3-50), exact percentile lists (p1, p5, p25, p75, p95, p99), and runnable PostgreSQL information_schema queries. Minor gaps: warehouse-specific SQL is PostgreSQL-only with no Snowflake/BigQuery variants, so short of anchor 5. | 4 / 5 |
Workflow Clarity | A clearly sequenced 7-step workflow with numbered sub-steps, explicit fallbacks when neither warehouse nor file is available, and a concrete output template. Read-only profiling triggers no destructive-operation cap, but there are no explicit verification checkpoints or feedback loops, so it sits at anchor 4 rather than 5. | 4 / 5 |
Progressive Disclosure | Well-headered single file, but at ~320 lines secondary material that belongs in reference files (schema documentation template, schema exploration SQL, pattern discovery techniques, quality assessment framework) is fully inlined rather than split out, and the only external pointer, ../../CONNECTORS.md, does not exist in the bundle. Structure is present but content that should be separate is inline, matching anchor 3 rather than 4. | 3 / 5 |
Total | 14 / 20 Passed |