Content
61%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 a well-structured, actionable MCP-tool playbook with concrete tool sequences, parameters, and pitfalls. Its main weaknesses are redundant pitfall duplication, a missing verification checkpoint on the destructive batch-profile update, and some inline reference material that could be split out.
Suggestions
Add an explicit verification/dry-run step to the batch profile-update workflow (e.g., query affected profiles first and confirm count before applying BATCH_UPDATE) to lift workflow clarity above the cap.
De-duplicate the 'Known Pitfalls' section against the per-workflow 'Pitfalls' blocks, or collapse one into a pointer to the other, to reduce token redundancy.
Consider moving the Quick Reference table and Mixpanel Expression Syntax reference into a separate references/ file, keeping SKILL.md a lean overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly actionable with no beginner-concept padding, but the 'Known Pitfalls' section repeats date-format and expression-syntax details already covered in per-workflow 'Pitfalls', and the Quick Reference table re-lists tool slugs/params, so it could be tightened. | 3 / 5 |
Actionability | Concrete tool slugs, explicit parameter lists, prerequisite/required/optional tags, and worked expression-syntax examples give mostly executable guidance; minor gaps are the absence of a single complete end-to-end query example. | 4 / 5 |
Workflow Clarity | Workflows are well sequenced with numbered tool steps and a setup validation checkpoint ('Confirm connection status shows ACTIVE'), but the destructive PROFILE_BATCH_UPDATE workflow lacks a verify/dry-run checkpoint before applying batch operations, capping clarity at 3. | 3 / 5 |
Progressive Disclosure | No bundle files exist and the skill is a single inline document; sections are well-organized with clear headers, no nested references, and a reasonable overview-to-detail split, though the Quick Reference and expression-syntax blocks could live in a separate reference file. | 4 / 5 |
Total | 14 / 20 Passed |