Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is a well-structured, actionable analysis skill with a clear sequenced workflow, but it carries redundancy between the workflow check steps and the standards catalog, and keeps all detail inline with no progressive disclosure. Both weak spots are tied to the lowest-scoring dimensions.
Suggestions
Collapse the overlap between Workflow steps 4-5 and the 'Core Checks' / 'Specific Check Guidance' standards sections so each check appears once; have the workflow reference the standards rather than restating them.
Move the full per-shape and per-domain check catalog (event/dimension/fact/ML/experiment checks, Specific Check Guidance) into a reference file (e.g., references/checks.md) and link to it from a concise overview, improving progressive_disclosure.
Add explicit verification checkpoints to the workflow (e.g., 'confirm grain before interpreting anomalies' is stated once in step 3 but not enforced as a gate before steps 4-6) so the sequence reads as a validated loop rather than a linear list.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and largely high-signal domain guidance rather than generic concepts Claude already knows, but Workflow steps 4-5 overlap materially with the 'Core Checks' and 'Specific Check Guidance' standards sections, so it could be tightened. Not level 3 because of that redundancy; not level 1 because it avoids generic explanatory padding. | 2 / 3 |
Actionability | For an instruction/analysis skill it gives concrete, specific check lists (null rate by column/partition, duplicate primary/composite keys, leakage from post-outcome fields, sentinel values like '', 0, -1) and points to inspectable tooling ($jupyter-notebooks, structured_data). Per the code_vs_instruction scoring note, absence of raw code is not penalized when guidance is this actionable. | 3 / 3 |
Workflow Clarity | An explicit 8-step workflow sequences the analysis from clarifying context through profiling, checks, temporal diagnostics, cause investigation, and recommendations. The feedback-loop cap does not apply because this is non-destructive analysis, not batch/destructive/database work. Not level 2 because the sequence and progression are clear rather than merely listed with implicit checkpoints. | 3 / 3 |
Progressive Disclosure | The document is well-organized into Workflow / Standards / Output Standards / Defaults sections, but it is a single ~160-line monolithic file with no bundle references to offload detail, and it exceeds the under-50-line simple-skill carve-out. Not level 1 because organization is strong; not level 3 because content that could be split (e.g., the full check catalog) is all inline. | 2 / 3 |
Total | 10 / 12 Passed |