Content
96%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.
A tight, highly actionable skill body: concrete tool calls and executable SQL, well-marked sharp edges, and clear workflow sequencing with fallbacks. Progressive disclosure is good but the skill leans on inline recipes since it ships no bundle files of its own.
Suggestions
Move the four SQL recipes into a local references/ file (e.g. references/sql-recipes.md) and link to it from 'When to drop to SQL' to further trim the body and enable one-level-deep lookup.
Consider extracting the tool table plus the 'gated behind mcp-analytics flag' note into a short reference so the SKILL.md body stays a pure overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean throughout: it opens with a one-line definition, a compact tool table, and only the sharp edges (the date-window trap, silent order_by fallback, dead distinct_id_count field) that Claude would not already know. No padding and no explanation of basic concepts. | 5 / 5 |
Actionability | Every workflow gives a copy-paste-ready JSON tool invocation with concrete parameters, and the SQL section provides complete, executable HogQL queries with exact column and property references — fully executable, not pseudocode. | 5 / 5 |
Workflow Clarity | Workflows are clearly sequenced (list -> read tool calls -> summarise intent) with explicit failure-mode checkpoints: the date-window trap is called out first, a 503 has a documented fallback, and the 'when to drop to SQL' section enumerates four numbered cases with recovery guidance. | 5 / 5 |
Progressive Disclosure | Good structure with the shared schema and cross-session recipes offloaded to a clearly signaled one-level reference (models-mcp.md) and related skills linked; the only gap is that no local references/ directory exists, so the body still carries the bulk of the SQL recipes inline rather than splitting them out. | 4 / 5 |
Total | 19 / 20 Passed |