Content
65%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
Highly actionable and well-sequenced MCP guidance, but it is over-long for a single SKILL.md with redundant pitfall/table sections and no progressive disclosure to reference files, and the batch-update workflow lacks a verification feedback loop.
Suggestions
Move the Quick Reference table and Mixpanel expression-syntax reference into a separate REFERENCE.md and link to it from the body, trimming the main file to a lean overview.
Consolidate the per-workflow 'Pitfalls' with the 'Known Pitfalls' section to remove duplication and recover token budget.
Add a verification step after MIXPANEL_PROFILE_BATCH_UPDATE (e.g., re-query affected profiles to confirm the operation applied) to satisfy the batch-operation feedback-loop requirement.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and assumes Claude's competence (no basic-concept padding), but it is redundant — per-workflow 'Pitfalls' sections are restated in a 'Known Pitfalls' section and again as a 'Quick Reference' table, so not every token earns its place. | 2 / 3 |
Actionability | Concrete tool slugs, exact parameter names, required formats ('YYYY-MM-DD'), and worked Mixpanel expression-syntax examples make the guidance copy-paste ready; the instruction-only nature is not penalized because guidance is actionable. | 3 / 3 |
Workflow Clarity | Sequences are numbered and the Setup flow has an explicit validation checkpoint ('Confirm connection status shows ACTIVE'), but the batch-update workflow (MIXPANEL_PROFILE_BATCH_UPDATE) has no verify/retry feedback loop, so per the rubric batch-operation workflow clarity is capped at 2. | 2 / 3 |
Progressive Disclosure | The single file is well-organized with clear headers, but at ~220 lines it keeps reference-style material (Quick Reference table, expression-syntax reference) inline rather than splitting to reference files, so it is not a lean overview pointing one level deep. | 2 / 3 |
Total | 9 / 12 Passed |