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.
The content is highly actionable with copy-paste ready CLI commands and a well-sequenced connection-state workflow with feedback loops. Its main weakness is mild verbosity in the introductory overview and the lack of any external reference files for the longer API/action material.
Suggestions
Trim or remove the opening "Mixpanel is a product analytics platform..." overview paragraph and the entity hierarchy list, which restate domain knowledge Claude already has.
Fix the orphaned "#### 1b. Wait for the connection to be ready" heading by adding a corresponding step 1a or renumbering the connection flow as an explicit ordered list.
Consider moving the popular-actions discovery examples and the proxy flags table into a bundled reference file (e.g. ACTIONS.md) referenced one level deep from the body.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient command-focused content, but the opening overview paragraph ("Mixpanel is a product analytics platform that helps businesses understand user behavior...") explains what Mixpanel is, and the entity hierarchy list adds little actionable value, fitting the anchor for mostly efficient with some unnecessary explanation. | 3 / 5 |
Actionability | It provides fully executable, copy-paste ready bash commands for the common cases (install, login, connection ensure, action run with JSON params, proxy requests) plus a concrete flags table, matching the anchor for fully executable examples covering common cases. | 5 / 5 |
Workflow Clarity | The install → auth → connection → poll states → search → run → proxy flow is clearly sequenced with explicit state checkpoints and a feedback loop (poll again until READY; handle CLIENT_ACTION_REQUIRED and error states), but the orphaned "1b" heading without a matching "1a" and section-based rather than numbered sequencing leave a minor structural gap. | 4 / 5 |
Progressive Disclosure | Content is well-organized into clearly headed sections with no nested references and no monolithic wall of text; however the skill is over 50 lines with no bundle files, and the popular-actions and proxy-flag reference material is inlined rather than split out, so it sits at good-but-not-ideal structure. | 4 / 5 |
Total | 16 / 20 Passed |