Content
100%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-structured investigation skill: lean, highly actionable, with an explicit sequenced workflow and validation/feedback loops, and proper progressive disclosure via verified one-level-deep references. Every token earns its place.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean and directive throughout: a tools table, two short script invocations, and a tight five-step flow with no re-explanation of PostHog, MCP, or analytics concepts Claude already knows. | 3 / 3 |
Actionability | Fully executable guidance — named MCP tools, concrete commands ('python3 scripts/compare_to_prior_periods.py < query_result.json', 'WINDOW=7 ...'), exact field references (query.kind, trendsFilter.display === "BoxPlot", compareFilter: {"compare": true}), and a copy-paste findings template. | 3 / 3 |
Workflow Clarity | Steps are explicitly sequenced (1 classify → 2 opening moves 2.1/2.2/2.3 → 3 playbook → 4 cross-check → 5 findings) with validation checkpoints: 2.2 'If the movement is normal variance, report that and stop' and Step 4's control-segment test with an expand branch. | 3 / 3 |
Progressive Disclosure | SKILL.md is a concise overview with clearly signaled one-level-deep references (seven playbooks, shared-patterns.md, common-causes.md) and two helper scripts; all referenced paths resolve to real bundle files, so navigation is clean. | 3 / 3 |
Total | 12 / 12 Passed |