Content
68%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 highly actionable with complete, copy-paste-ready CLI commands and well-organized sections, but it is held back by an unnecessary intro paragraph, a loose step numbering scheme, and missing verification steps for its batch data operations.
Suggestions
Add a verification/retry step after batch and export actions (e.g. re-query or check the response status) so batch workflows include an explicit feedback loop.
Fix the step numbering: label 'Step 2' explicitly (or remove the 'skip to Step 2' reference) and add a '1a' to pair with the '1b' subsection.
Trim the opening paragraph that explains what Amplitude is and who uses it, plus the filler line 'Use action names and parameters as needed.'
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient command examples and tables, but the opening paragraph over-explains what Amplitude is and who uses it, and 'Use action names and parameters as needed.' is vague filler that could be trimmed. | 3 / 5 |
Actionability | Provides copy-paste-ready commands for every common case (install, login, connection ensure, action list/run, request) with full flag tables and a popular-actions table, fully executable and covering the common cases. | 5 / 5 |
Workflow Clarity | There is a clear sequence with a connection-state feedback loop, but batch operations (track-events 'in batch', export-events) lack verification steps, and the batch-cap guideline caps workflow clarity at 3; the 'skip to Step 2' reference with no labeled Step 2 or '1a' also loosens the sequence. | 3 / 5 |
Progressive Disclosure | No bundle files exist; the ~155-line body is well-organized into clear headed sections with easy navigation, but it is monolithic (popular-actions and proxy-flag tables inline) and over 50 lines, so it sits at good structure with minor gaps rather than the simple-skill 5. | 4 / 5 |
Total | 15 / 20 Passed |