reddit-search
Research public Reddit posts, comments, communities, and explicitly requested profiles for pain points, product opinions, and discussion evidence.
How do I install this agent skill?
npx skills add https://github.com/postplusai/postplus-skills --skill reddit-searchIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill facilitates public Reddit research via a vendor-specific CLI tool. It includes robust constraints on data privacy, budget management, and user approval. The only identified security concern is the inherent vulnerability to indirect prompt injection, as the agent must ingest and process untrusted text from Reddit posts and comments.
- Socketpass
No alerts
- Snykwarn
Risk: MEDIUM · 1 issue
What does this agent skill do?
Reddit Search
Use this skill for bounded public Reddit research.
Experience Rules
- Speak in the user's business language, not collection terminology.
- Ask at most one question, and only when it changes the route or credit bound.
- Start with the smallest useful sample and expand only after review.
- Keep implementation, delivery, and network controls out of the conversation.
- Fail fast on hard command, contract, auth, or private-surface failures. When a supported run completes with empty, sparse, noisy, or off-topic evidence, apply the quality rules below before concluding that the evidence is exhausted.
Route Index
Read only the matching route reference before execution. Read result-shape details only when transforming completed records; they are not a preflight.
| User asks for | Route references | Default first pass |
|---|---|---|
| Keyword posts, communities, or a Reddit search URL | references/search.md | 20 posts or 10 communities |
| Keyword comment evidence | references/search.md; read references/post-comments.md only after selecting threads | 20 discovery posts, then up to 3 relevant threads |
| One supplied post URL's comments | references/post-comments.md | 1 post and up to 50 comments |
| A guided pain-point or product-opinion deep-dive | references/search.md; read references/post-comments.md only after selecting threads | 20 discovery posts, then 3 suggested threads |
| A subreddit search, feed, metadata, or deep collection | references/community.md | 20 feed posts; deep scope is bounded separately |
| An explicitly named public Reddit profile and its activity | references/profile.md | 20 posts and 20 comments |
| Result transformation needs fields beyond the summary below | references/result-shapes.md | Preserve the raw result file |
First Question
Do not ask when the user supplied a keyword, URL, subreddit, or profile and a safe default applies. Otherwise ask only the highest-information question:
| Missing decision | Ask |
|---|---|
| No research target | What Reddit topic, URL, subreddit, or public profile should I research? |
| A deep subreddit request has no bound | What date range or maximum post count should bound the deep collection? |
| Multiple expensive directions compete | Which one should I run first: discovery, a thread deep-dive, a subreddit, or a public profile? |
Never ask for credentials, schema fields, implementation choice, delivery settings, or retry strategy.
Run Protocol
- Select one route and apply its references.
- Run the narrowest semantic route that answers the first pass.
- Keep the JSON result under
.postplus/as durable evidence. - Inspect record types and relevance. If the evidence is not useful, apply the quality rules below without repeating an identical request or exceeding the approved PostPlus credit bound.
- Keep the complete raw records in the result file; normalize only the
user-facing evidence; read
references/result-shapes.mdonly if more field interpretation is needed. - Report scope, counts by result type, representative evidence, limits, and one useful next action. Do not imply a bounded pass is exhaustive.
Multiple keywords are separate, attributable requests. They may run in parallel, but their result sets remain separate until presentation.
Public Command Boundary
- Readiness:
postplus doctor --skill reddit-search. - Inspect route flags only when needed with
postplus research run <route> --help. - Select the route:
reddit-searchfor keyword discovery, public search URLs, community search, and ordinary subreddit feeds;reddit-post-commentsfor one or more selected post threads;reddit-subreddit-postsfor bounded deep subreddit collection;reddit-user-activityfor an explicitly named public profile.
- Run
postplus research run <route> --<query/url/subreddit/handle flags> --limit <n> --wait --output <result.json>. - Use only the semantic flags shown by the selected route.
- If a run returns a saved async checkpoint, resume it with
postplus research run --resume-from <result.json>rather than starting a duplicate run. - Requested tasks use existing PostPlus credits after the current price and balance are checked. Estimate-only requests do not execute. Stop on insufficient credits; do not recharge, buy a subscription, or repeat an uncertain paid operation.
Scope Boundary
Supported: public keyword discovery, public search URLs, public post threads, public subreddit content and metadata, and explicitly requested public profile activity.
Excluded: login or account access, posting or messaging, private/deleted content recovery, real-identity inference, private-data enrichment, automated sentiment analysis, media download, external delivery, and network tuning.
Command Selection
| Need | Route | Flags |
|---|---|---|
| Keyword/search URL/feed discovery | reddit-search | repeat --query or --url, plus sort/time-range/limit |
| Selected thread comments | reddit-post-comments | repeat --url, plus limit |
| Deep subreddit pass | reddit-subreddit-posts | repeat --subreddit, optional --posted-after, plus limit |
| Named public profile | reddit-user-activity | repeat --handle, post-limit, comment-limit |
Only if platform scope or evidence interpretation remains unclear, consult platform contract; it is not a preflight.
Evidence Quality
- Classify records before drawing conclusions: discovery posts identify threads; comment claims require actual comments.
- For keyword comment research, discover posts first, then inspect up to three relevant threads; change a poor discovery query before expanding.
- Allow at most two changed follow-up passes after successful but insufficient results, within approved scope and budget; do not repeat an identical request or hide a failed/pending operation.
- Stop when sufficient, at the bound, or when another pass would not help. Report useful evidence and uncertainty; preserve raw results and source links.
Use dataType + id for deduplication; preserve comment parent IDs and depth. Missing values are unknown, not zero.
Full machine fields belong to postplus research schema --route <route> --json;
consult it only when required for processing, not before every request.
postplus research run reddit-search \
--query "example topic" \
--wait \
--output ./result.json
Follow the CLI's structured result and reported next action; do not infer recovery from free-text messages. Use existing PostPlus credits for requested work within existing authorization; estimate-only requests do not execute. Do not recharge, buy subscriptions, publish or change external advertising spend without applicable authorization. An initial reservation is not a final price or a hard cost cap. If a required hard final-cost limit cannot be enforced, do not execute; explain that limit. Correct definite pre-submission field or format errors without changing the requested intent, mode or output constraints. After submission or an unknown outcome, resume the same operation through its returned checkpoint or action; never resubmit uncertain work, repeat exhausted recovery, or switch providers to bypass failure. Keep raw results, operation identifiers and recovery commands in execution records. In ordinary chat, give the result, meaningful limitations, known cost and any necessary user decision; do not narrate uploads, polling, internal identifiers or JSON. When asked how media was made, provide the actual model, submitted prompt in the user language and references actually submitted with their roles.
<!-- END GENERATED EXECUTION EXAMPLE -->How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/postplusai/postplus-skills/reddit-search">View reddit-search on skillZs</a>