Content
67%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 concrete CLI commands and a sensible workflow including a connection-state feedback loop, but it carries some unnecessary explanatory prose and has a small numbering inconsistency in the connection steps.
Suggestions
Cut the introductory paragraph describing what ScrapingAnt is and who uses it; Claude can infer this, and it competes with context tokens.
Fix the broken step navigation: replace "skip to Step 2" with a concrete heading reference and renumber the "1b" block so the install/auth/connect sequence is unambiguous.
Expand or remove the near-empty "Popular actions" section so it either lists representative actions or simply folds into "Searching for actions".
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient CLI commands, but the introductory paragraph ("ScrapingAnt is a web scraping API... used by developers and data scientists... market research, SEO monitoring") and phrases like "so you can focus on the integration logic rather than auth plumbing" explain context Claude can infer. | 3 / 5 |
Actionability | It provides copy-paste-ready commands for install, login, connection, action listing/running, and proxying, plus a flags table; minor gaps are the generic CONNECTION_ID placeholders and the thin "Popular actions" section. | 4 / 5 |
Workflow Clarity | There is a clear sequence (install → auth → connect → search → run) with a polling feedback loop for connection state (BUILDING / CLIENT_ACTION_REQUIRED / READY), though step references are slightly broken ("skip to Step 2" with no labeled Step 2, and a "1b" that disrupts the numbering). | 4 / 5 |
Progressive Disclosure | No bundle files exist and none are needed for this CLI-driven skill; the body is organized into clearly headed sections (Overview, Working with ScrapingAnt, Best practices) with only minor organization gaps in the sparse "Popular actions" section. | 4 / 5 |
Total | 15 / 20 Passed |