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 single-file skill with exact tool sequences, parameters, and validation feedback loops for async operations. Its main weakness is redundancy: pitfalls and tool lists are repeated across the workflow sections, 'Known Pitfalls', and the Quick Reference table, plus a vacuous 'When to Use' section.
Suggestions
Drop or merge the 'Known Pitfalls' section into the per-workflow 'Pitfalls' blocks (or keep only pitfalls that span multiple workflows) to remove the duplicated user-ID, timestamp, and async-cohort warnings.
Delete the vacuous 'When to Use' section ('This skill is applicable to execute the workflow or actions described in the overview') — it adds no information.
Consider moving the per-tool parameter details into a references/ file (e.g. TOOL_REFERENCE.md) and keeping SKILL.md as an overview with the Quick Reference table, which would improve both conciseness and progressive disclosure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly dense, tool-specific content Claude cannot know (tool slugs, parameters, pitfalls), but the 'Known Pitfalls' section duplicates per-workflow pitfalls (user-ID resolution, millisecond timestamps, async cohort updates all appear twice), the Quick Reference table re-lists the same tools and params a third time, and the 'When to Use' section ('This skill is applicable to execute the workflow or actions described in the overview') is vacuous filler. Fits anchor 3 (mostly efficient but could be tightened); not 2 since most content earns its place, not 4 since the redundancy is more than minor. | 3 / 5 |
Actionability | Gives exact tool slugs (AMPLITUDE_SEND_EVENTS, AMPLITUDE_FIND_USER), exact parameter names, numbered call sequences, a concrete JSON payload example for IDENTIFY, and an async polling loop covering all five common workflows. Unspecified details (batch limits) are explicitly and justifiably delegated to the RUBE_SEARCH_TOOLS schema lookup. Matches anchor 5: copy-paste-ready instructions covering common cases. | 5 / 5 |
Workflow Clarity | Every workflow has a numbered 'Tool sequence' with 'When to use'; setup validates the connection is ACTIVE before any workflow runs; and the risky batch operation (cohort membership update) has an explicit feedback loop (poll AMPLITUDE_CHECK_COHORT_STATUS until 'complete' or 'error'). Minor gap keeps it below 5: event sends are flagged as async with no verification step, and there is no error-recovery guidance beyond polling. | 4 / 5 |
Progressive Disclosure | Single-file skill with no bundle files, but genuinely well-organized: a consistent per-workflow template (When to use / Tool sequence / Key parameters / Pitfalls), a Common Patterns section, and a Quick Reference table make navigation easy. Not 5 because ~210 lines of per-tool parameter detail could plausibly be split into a reference file; not 3 because structure and navigation are clearly good. | 4 / 5 |
Total | 16 / 20 Passed |