Content
57%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 skill provides concrete, executable guidance through a clear five-step workflow, but it inlines a large reference table that belongs in a separate file and lacks validation checkpoints for its batch scraping operations.
Suggestions
Move the 27-row actor-selection table into a references file (e.g. actors.md) and link to it from Step 1 to improve progressive disclosure and token efficiency.
Add an explicit validation checkpoint between fetching the actor schema (Step 2) and running it (Step 4), e.g. confirm required input parameters are present before execution.
Trim minor filler ("Copy this checklist and track progress:", "(No need to check it upfront)") and verify the referenced run_actor.js script exists in the bundle.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient with executable commands and a useful actor-selection table, but the 27-row actor table is bulk reference material that would be more token-efficient in a separate file, and minor padding ("Copy this checklist and track progress:", "(No need to check it upfront)") could be trimmed. | 3 / 5 |
Actionability | Steps 2 and 4 give concrete, copy-paste-ready bash commands with real actor IDs and flag combinations, with only minor gaps such as the referenced run_actor.js script not being present in the bundle. | 4 / 5 |
Workflow Clarity | A clear five-step sequence with a progress checklist and an error-handling section is present, but running Apify scrapers is a batch operation with no explicit validation/verification checkpoint before or after the run, which caps workflow clarity at 3 per the rubric. | 3 / 5 |
Progressive Disclosure | The body is well-sectioned but essentially monolithic: the large actor-selection table and script invocations are inlined rather than split into reference files, and there are no one-level-deep references to navigate to. | 3 / 5 |
Total | 13 / 20 Passed |