Content
50%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill provides a comprehensive catalog of Mixpanel operations via Rube MCP with clear tool naming and parameter documentation. Its main weaknesses are the lack of concrete executable examples (tool calls with realistic parameters), repeated information across sections (especially date format and expression syntax warnings), and missing validation steps for destructive batch operations. The content would benefit from being more concise and splitting detailed reference material into separate files.
Suggestions
Add concrete, copy-paste ready tool invocation examples with realistic parameter values for at least the most common workflows (e.g., aggregate events, segmentation)
Consolidate repeated pitfalls (date formats, expression syntax, case sensitivity) into the 'Known Pitfalls' section and remove duplicates from individual workflow sections
Add explicit validation/verification steps to the batch update workflow (e.g., 'Query updated profiles to confirm changes applied correctly')
Split the expression syntax reference and detailed workflow guides into separate bundle files, keeping SKILL.md as a concise overview with links
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is moderately verbose with repeated pitfall sections across each workflow that share overlapping information (e.g., date format warnings appear multiple times). The expression syntax is documented both inline in workflows and in a dedicated section. The 'When to Use' footer is vacuous. However, much of the content is genuinely useful reference material Claude wouldn't know. | 3 / 5 |
Actionability | The skill provides tool names, parameter lists, and expression syntax examples, which is helpful. However, there are no executable code examples or copy-paste ready tool invocations with actual parameter values. The 'Common Patterns' section uses pseudocode-style numbered lists rather than concrete tool call examples with realistic parameters. | 3 / 5 |
Workflow Clarity | Each workflow has a clear tool sequence with prerequisite/required labels, which is good. However, the batch update workflow (Section 4) involves destructive operations on user profiles but lacks explicit validation/verification steps or feedback loops. There's no 'verify the update succeeded' step or error recovery guidance for batch operations, which should cap this at 3. | 3 / 5 |
Progressive Disclosure | The content is a single monolithic file with no bundle files or external references. At ~200+ lines covering 6 distinct workflows plus common patterns and a quick reference table, some of this content (like the expression syntax reference or detailed workflow guides) would benefit from being split into separate files. The internal structure with headers is reasonable but the file is dense. | 3 / 5 |
Total | 12 / 20 Passed |