Content
92%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A highly actionable, well-sequenced deep-dive with executable guidance and proper validation loops; its only weakness is progressive disclosure, since all detail lives inline in one long file rather than being split into signaled reference files.
Suggestions
Move the detailed materialisation rewrite patterns (cohort/compare, JOIN+variables, missing variables, HogQL pitfalls) and the query_log SQL snippet into a referenced file such as references/materialization-patterns.md, keeping SKILL.md as a tighter overview that links one level deep.
Extract the Available tools table into a references/tools.md (or keep a one-line summary inline) so the core decision tree and workflow stay foregrounded in the main file.
Tighten the Example interaction's internal monologue to the key diagnosis and recommendation, trimming the explanatory prose that re-states points already covered in the decision tree.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Dense PostHog-specific operational detail (TTL enum values, JOIN+variable materialisation trap, eligibility contract) with no generic concept padding Claude already knows; every section earns its place despite minor repetition in the closing notes. | 3 / 3 |
Actionability | Names exact tools, gives a copy-paste query_log SQL block, concrete decision-tree branches, and the literal API path to parse the endpoint name from — fully executable, not pseudocode. | 3 / 3 |
Workflow Clarity | A numbered workflow and ordered decision tree carry explicit validation checkpoints ("compare the results; only then apply", "confirm before applying it", "confirm first"), providing the validate→fix→retry loops the destructive query-rewrite step needs. | 3 / 3 |
Progressive Disclosure | Sections are well organized with easy navigation, but the skill is a ~190-line monolith with all detail inline and no reference files; the under-50-line simple-skill exemption does not apply, so the split-into-references pattern of the top anchor is only partially met. | 2 / 3 |
Total | 11 / 12 Passed |