Content
83%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-organized, actionable skill body that inlines the canonical query and delegates the rest to a single shared reference with clear navigation. Minor conciseness trimming and a more explicit cross-tool validation checkpoint would lift it to the top anchors.
Suggestions
Tighten the 'two rules' and matrix/failures prose to bullets or shorten the repeated models-mcp.md cross-links to recover conciseness.
Add an explicit verification checkpoint to the cross-tool workflow — e.g. 'if your SQL ranking disagrees with the tool-quality screen, prefer the typed tool' as a numbered validate step rather than a note.
Consider moving the failure-bucketing SQL inline block entirely to the reference since the typed posthog:query-mcp-tool-failures tool is the recommended path, leaving only the headline error-rate query in the body.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean and assumes Claude's competence — inlines only the headline query and defers the rest to the shared reference — but the two-rules section, the matrix/failures prose, and repeated cross-links to models-mcp.md add a little that could be trimmed. | 4 / 5 |
Actionability | Provides copy-paste-ready HogQL/SQL for the canonical error-rate and failure-bucketing queries, names the exact typed tools with their parameters, and gives explicit UI link templates — covering the common cases concretely. | 5 / 5 |
Workflow Clarity | The error-rate workflow is well sequenced with a HAVING-volume guard and rate+volume reporting guidance, but the queries are read-only analytics rather than destructive/batch operations, and the cross-tool path lacks an explicit validate-against-the-screen checkpoint beyond a 'prefer the typed tool' note. | 4 / 5 |
Progressive Disclosure | Good structure with clear section headers and well-signaled one-level-deep references to a single shared reference (models-mcp.md) plus related skills; the inline headline query is justified, though the body still carries a fair amount of detail that lives in the reference. | 4 / 5 |
Total | 17 / 20 Passed |