Content
75%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 well-structured, actionable skill body with concrete SQL recipes, typed-tool guidance, and sensible governance checkpoints. It loses points mainly for a slightly padded opening, a couple of incomplete recipes (slowest tools, matrix), and reliance on a cross-skill reference rather than a local bundle file.
Suggestions
Tighten the opening paragraph: drop 'This is the data behind the MCP analytics dashboard and tool-quality screens.' and lead directly with the actionable data-model facts Claude needs.
Inline a complete slowest-tools query (the p95 latency ranking) rather than only a transformation hint, so the common cross-tool latency case is copy-paste ready like the error-rate recipe.
Add an explicit verify step after running a typed tool or SQL recipe (e.g., cross-check the headline against the tool-quality screen URL) to close the workflow_clarity validation gap.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Largely lean and assumes Claude's knowledge of MCP/PostHog/HogQL, but the opening data-model paragraph ('There is no dedicated ClickHouse table... This is the data behind the MCP analytics dashboard and tool-quality screens.') and a few restatements could be trimmed. | 4 / 5 |
Actionability | Provides copy-paste-ready SQL for the error-rate ranking and failure-bucket recipes plus named typed tools with parameters and URL templates, but the slowest-tools workflow is only a transformation hint ('Swap the aggregate... order by p95_ms') and the matrix query is offloaded to an external file. | 4 / 5 |
Workflow Clarity | Clear sequencing with a governed-metric-first checkpoint (run metric-list, check approval, label derived rates noncanonical) and a HAVING-floor noise guard, plus a drift check against mcp_harness.py; minor validation gaps remain since these are read-only queries without explicit error-recovery loops. | 4 / 5 |
Progressive Disclosure | Well-organized with section headers and a clearly signaled, one-level-deep reference to the shared models-mcp.md for bulk recipes, but that reference is a cross-skill path outside this skill's own bundle (no local references/ dir) rather than a local file, a minor organization gap. | 4 / 5 |
Total | 16 / 20 Passed |