Content
76%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 executable commands and a well-sequenced connection workflow, but it lacks validation/confirmation checkpoints around destructive operations and could offload the large actions table to a reference file.
Suggestions
Add an explicit validation/confirmation step before destructive actions (delete-campaign, delete-ad-group, delete-keyword, delete-product-ad) — e.g. confirm with the user or list affected resources before archiving.
Move the 20-row "Popular actions" catalog into a references/ file and keep only a representative few inline with a pointer, improving token efficiency and progressive disclosure.
Trim the platform-intro paragraph ("Amazon Advertising is a platform used by businesses...") since it explains a concept Claude already knows.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient with concrete commands, a flag-options table, and minimal padding; only minor over-explanation (the platform-intro paragraph and the 20-row actions table that partly duplicates action-search) keeps it from a 5. | 4 / 5 |
Actionability | It provides copy-paste-ready membrane commands with --json flags, explicit JSON parameter passing via --input, and a proxy-request flag table covering the common cases, matching the anchor for fully executable guidance. | 5 / 5 |
Workflow Clarity | The connection setup is clearly sequenced with state branches and polling feedback loops, but destructive/batch operations (delete-campaign, delete-ad-group, delete-keyword, delete-product-ad) appear in the actions table with no validation or confirmation checkpoint, which caps workflow clarity at 3 per the destructive-operations rule. | 3 / 5 |
Progressive Disclosure | The skill is a single well-organized file with clear section headers and no bundle files present; the only gap is the inlined 20-row action catalog that could arguably be split into a reference file, leaving minor organization gaps rather than a monolithic wall. | 4 / 5 |
Total | 16 / 20 Passed |