Content
72%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 skill body with copy-paste commands and a clear schema, but it lacks validation checkpoints for a batch scraping workflow and points to a `references/apify-config.md` file that does not exist in the bundle.
Suggestions
Add a validation/verification step to the workflow (e.g. check the actor run status, confirm ads were returned, and handle empty results before reporting) to lift workflow_clarity above the batch-operation cap of 3.
Create the referenced `references/apify-config.md` file or remove the dangling reference so progressive disclosure points to real bundle content.
Trim the 'How It Works' prose and the restated 'Compare Multiple Competitors' workflow, since the Quick Start examples already convey the same usage.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is well-organized and mostly lean, with copy-paste-ready commands and a tight CLI reference table; minor padding like the 'How It Works' prose and the 'Compare Multiple Competitors' workflow restating usage keep it just below a 5. | 4 / 5 |
Actionability | Provides fully executable, copy-paste-ready commands covering the common cases (company, country, keyword, page URL, ad-status, output formats), a complete CLI reference table, and a concrete output-field schema — all directly runnable. | 5 / 5 |
Workflow Clarity | The 'How It Works' steps give a clear sequence, but this batch scraping operation has no validation or verification checkpoint (e.g. checking the run succeeded before trusting data, handling empty/partial results), and the rubric caps batch operations without validation at 3. | 3 / 5 |
Progressive Disclosure | The body is well-sectioned, but it references `references/apify-config.md` for API configuration while no `references/` directory exists in the bundle, so the signaled one-level-deep reference is broken; the inline content that should live in that file (cost, rate limits) is partially inlined instead. | 3 / 5 |
Total | 15 / 20 Passed |