Content
73%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.
Highly actionable and well-structured content with executable commands and a verified backing script, but the workflow lacks explicit validation/verification checkpoints for a batch remote-API operation, which caps workflow clarity.
Suggestions
Add an explicit validation step after the search: check that the Apify run succeeded (script exits non-zero / prints status) and that results are non-empty before filtering, with guidance to retry or adjust criteria on failure.
Verify required env vars (GOOSEWORKS_API_KEY or APIFY_API_TOKEN) as Step 0 before composing the search command, so token failures are caught early.
Trim the Step 3 filter rules that duplicate logic already handled by the script's --min-followers/--max-followers/--min-fit flags to reduce redundancy.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly lean with executable commands, a tight CLI reference table, and only a few mild over-explanations (e.g. restating filtering rules the script already implements); it is efficient but could trim the duplicated filter logic in Step 3. | 4 / 5 |
Actionability | Copy-paste ready bash commands with real flags, a complete CLI reference table, and a verified backing script (find_influencers.py) make the guidance fully executable across the common cases. | 5 / 5 |
Workflow Clarity | Steps 1-4 are clearly sequenced, but this is a batch remote API operation with no validation checkpoint: there is no step to verify the Apify run succeeded, confirm the token/env var is set before running, or handle empty/failed results before presenting, so the destructive/batch cap of 3 applies. | 3 / 5 |
Progressive Disclosure | Content is well-organized into Quick Start, numbered steps, CLI reference, and Notes, with the heavy logic correctly offloaded to the bundled scripts/find_influencers.py; no nested references and easy to navigate, though there is no explicit pointer to the script file beyond inline command paths. | 4 / 5 |
Total | 16 / 20 Passed |