Reddit Search

Reddit Search

Use this skill for bounded public Reddit research. Apply the shared rulebook and user-guidance rules from postplus-shared. When a supported command completes but evidence is empty, sparse, noisy, off-topic, or the wrong record type, apply the postplus-shared reference research-quality-recovery.md; hard execution errors still fail fast.

Experience Rules

1. Speak in the user's business language, not collection terminology.
2. Ask at most one question, and only when it changes the route or credit bound.
3. Start with the smallest useful sample and expand only after review.
4. Keep implementation, delivery, and network controls out of the conversation.
5. 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 shared bounded research-quality recovery rule before concluding that the evidence is exhausted.

Route Index

Read references/shared-contract.md for every route, then the route reference and references/result-shapes.md. All references are direct from this 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:

Never ask for credentials, schema fields, implementation choice, delivery settings, or retry strategy.

Run Protocol

1. Select one route and apply its references.
2. Run the narrowest semantic route that answers the first pass.
3. Keep the JSON result under .postplus/ as durable evidence.
4. Inspect record types and relevance. If the evidence is not useful, apply the recovery flow in references/shared-contract.md without repeating an identical request or exceeding the approved PostPlus credit bound.
5. Keep the complete raw records in the result file; normalize only the user-facing evidence according to references/result-shapes.md.
6. 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-search for keyword discovery, public search URLs, community search, and ordinary subreddit feeds;
  • reddit-post-comments for one or more selected post threads;
  • reddit-subreddit-posts for bounded deep subreddit collection;
  • reddit-user-activity for 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.
• If a quote-confirmation challenge appears, show its scope and PostPlus credits. Only after the user confirms, run postplus quote confirm --json --challenge-file <challenge.json> and retry with the returned token.
• If an owned CLI command fails, report the exact error and stop. Do not use unpublished tools, payload rewrites, or another service as a fallback.

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.

postplus research run reddit-search \
  --wait \
  --output ./result.json