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 highly actionable, well-structured API reference that leverages help.py and WebFetch for progressive disclosure and provides strong discovery/validation workflows. Its main weakness is verbosity — general analytical-philosophy prose and inlined reference bulk inflate the body beyond a lean overview.
Suggestions
Trim the general analytical-philosophy prose (e.g. 'Distrust averages', social-vs-B2B cadence analogies) to the Mixpanel-specific quirks and silent defaults; Claude already knows to distrust averages.
Move the bulkier reference material (full per-method parameter lists, the custom-property formula reference, entity CRUD method inventories) into a separate REFERENCE.md and keep SKILL.md as an overview with links, relying more heavily on the help.py delegation pattern already in use.
Add an explicit validate-before-act feedback loop for destructive operations (e.g. preview_deletion_filters → confirm → create_deletion_request → verify) so the data-deletion workflow matches the validation rigor of the discovery workflow.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient and Mixpanel-specific, but the ~1000-line body carries substantial prose on general analytical philosophy ("Distrust averages", "Counting methodology is a modeling choice", social-vs-B2B cadence analogies) that could be tightened without losing the valuable Mixpanel-specific quirks. | 3 / 5 |
Actionability | Fully executable, copy-paste-ready Python examples and concrete commands ("python3 $SKILL_DIR/scripts/help.py Workspace.query") cover the common query/flow/retention/user cases, matching the top anchor. | 5 / 5 |
Workflow Clarity | The Discovery (two-step, verify-with-help.py) and Exploratory Analysis (Steps 1-5) workflows are clearly sequenced with validation checkpoints; minor gap is that destructive operations (data deletion, delete_* entity methods) are listed without an explicit validate-before-act feedback loop. | 4 / 5 |
Progressive Disclosure | Excellent one-level-deep delegation to scripts/help.py for full signatures and WebFetch for full external references, with clear section headers; however a large volume of API reference (inlined query signatures, formula reference, entity CRUD method lists) still lives in the body rather than in separate reference files. | 4 / 5 |
Total | 16 / 20 Passed |