Content
57%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 well-structured, highly actionable MCP tool guide with exact tool slugs, parameters, and useful domain pitfalls. Its weaknesses are redundancy between per-workflow pitfalls and the 'Known Pitfalls' section, a missing verification loop for the batch event-ingestion workflow, and an inlined ~220-line tool reference that would benefit from progressive disclosure into reference files.
Suggestions
Add an explicit validation/feedback step to the Send Events workflow (e.g., verify ingestion by checking the user's recent activity or reporting the async caveat with a bounded re-check) since it is a permanent batch operation.
Deduplicate pitfalls: keep them in one place, either per workflow or in 'Known Pitfalls', and cut the filler 'When to Use' sentence and generic 'Limitations' bullets.
Move the per-tool parameter documentation and Quick Reference table into a references/ file, keeping SKILL.md as a lean overview with clearly signaled links.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient, Amplitude-specific guidance, but there is noticeable tightening to do: the 'Known Pitfalls' section substantially repeats pitfalls already given per workflow (internal vs application user IDs, millisecond timestamps), and 'When to Use' ('This skill is applicable to execute the workflow or actions described in the overview.') plus the first 'Limitations' bullets are boilerplate filler. It does not fall to 2 because the core content (tool sequences, parameters, ID resolution patterns) earns its tokens with little explanation of concepts Claude already knows. | 3 / 5 |
Actionability | Concrete, executable guidance throughout: exact tool slugs, numbered tool sequences, named parameters, a JSON example for user_properties operations, and an explicit async polling pattern — matching anchor 4 ('mostly executable guidance; concrete code or commands with minor gaps'). Not 5 because some details are left vague ('check schema for maximum events per request', 'Extract Amplitude's internal user ID from response' without naming the response field). | 4 / 5 |
Workflow Clarity | Sequences are clearly listed and some validation exists (confirm connection ACTIVE before workflows; CHECK_COHORT_STATUS polling loop), but the batch event-ingestion workflow — a permanent, batch operation — has no verification/feedback step ('successful API response does not mean data is immediately queryable' is noted without a follow-up check). Per the judging guidelines, missing validation in batch operations caps workflow clarity at 3; the cap keeps it from 4 despite otherwise strong sequencing. | 3 / 5 |
Progressive Disclosure | Section structure is clear (Prerequisites, Setup, Core Workflows, Common Patterns, Quick Reference), but the ~220-line body inlines a per-tool parameter and pitfall reference that could live in separate reference files, and there are no external references at all — matching anchor 3 ('content that should be separate is inline'). Not 4 because the bulk of the body is API-reference material rather than a lean overview, and not 2 because sections are well-organized and navigable. | 3 / 5 |
Total | 13 / 20 Passed |