Content
88%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 script skill: executable commands everywhere, a complete CLI reference, and useful edge-case guidance. The main issues are minor — duplicated output-field documentation, and a references/apify-config.md that contradicts the body by documenting a different actor (parseforge/reddit-posts-scraper with required proxyConfiguration) rather than the trudax/reddit-scraper-lite actor the script actually uses.
Suggestions
Rewrite references/apify-config.md to document the trudax/reddit-scraper-lite actor the script actually uses — it currently describes parseforge/reddit-posts-scraper and claims proxyConfiguration is required, directly contradicting the SKILL.md body.
Merge the 'Output fields' bullet list under 'Direct API Usage' with the 'Output Format' section to remove the duplicated field documentation.
Consider moving the 'Direct API Usage' details (required input fields, unsupported fields) into references/apify-config.md so SKILL.md stays a lean overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with genuinely non-obvious operational detail (actor quirks, unsupported input fields, CLI table, workflows) with almost no padding, but output fields are documented twice — once as a bullet list under 'Direct API Usage' and again as the 'Output Format' JSON block. Matches anchor 4's 'minor instances that could be trimmed'; not 5 because of that duplication. | 4 / 5 |
Actionability | Copy-paste-ready commands for every common case (quick start plus three named workflows), a complete CLI flag table with defaults, a real script path that exists in the bundle, and the required env var stated up front. Fully executable and covering the common cases, matching anchor 5. | 5 / 5 |
Workflow Clarity | A simple single-command skill whose single action is unambiguous (run search_reddit.py with documented flags), and it includes explicit failure-mode recovery guidance ('Small or low-traffic subreddits... may return zero posts with --sort hot... Use --sort top --time week instead'). Per the simple-skill note this earns 5; the operation is read-only scraping, so the destructive/batch validation cap does not apply. | 5 / 5 |
Progressive Disclosure | Bundle structure is good: one script and one reference file, both real, one level deep, and the reference is clearly signaled ('See references/apify-config.md for detailed API configuration, token setup, and rate limits'). However, the inline 'Direct API Usage' section duplicates the reference file's territory (and the reference describes a different actor with contradictory required fields), which is a minor organization/consistency gap matching anchor 4 rather than 5. | 4 / 5 |
Total | 18 / 20 Passed |