CtrlK
BlogDocsLog inGet started
Tessl Logo

reddit-post-finder

Scrape and search Reddit posts using Apify. Use when you need to find Reddit discussions, track competitor mentions, monitor product feedback, discover pain points, or analyze subreddit content. Supports keyword filtering, time-based searches, and subreddit-specific queries.

72

Quality

90%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

88%Weight 40%Scale 1-5

Reviews 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.

DimensionReasoningScore

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

Description

87%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: concrete capabilities, an explicit 'Use when' clause with natural trigger phrases, and a clearly distinct niche. The only minor weakness is that trigger coverage and capability coverage could each add a few more synonyms (e.g. threads, comments, sorting).

DimensionReasoningScore

Specificity

Names the domain ('Scrape and search Reddit posts using Apify') and lists several concrete actions ('keyword filtering, time-based searches, and subreddit-specific queries'), with minor gaps such as comment scraping and output formats. It falls short of anchor 5's comprehensive coverage but exceeds anchor 3's 1-2 action limit.

4 / 5

Completeness

Explicitly answers both: what ('Scrape and search Reddit posts using Apify... Supports keyword filtering, time-based searches, and subreddit-specific queries') and when ('Use when you need to find Reddit discussions, track competitor mentions, monitor product feedback, discover pain points, or analyze subreddit content') with concrete trigger phrases, matching the anchor-5 example structure. Not below 5 because neither half is vague or implied.

5 / 5

Trigger Term Quality

'Reddit discussions', 'competitor mentions', 'monitor product feedback', 'discover pain points' are phrases users would naturally say. A few natural variations are missing (e.g. 'threads', 'mentions of X'), keeping it below anchor 5 but clearly above anchor 3's partial coverage.

4 / 5

Distinctiveness Conflict Risk

Clear niche (Reddit scraping via Apify) with distinct triggers ('Reddit', 'subreddit', 'competitor mentions') that would not plausibly fire a different skill. Matches anchor 5's 'clear niche with distinct triggers; minimal conflict risk'.

5 / 5

Total

18

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
gooseworks-ai/goose-skills
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.