Reddit (read only - no auth)

Browse and search Reddit in read-only mode using public JSON endpoints. Use when the user asks to browse subreddits, search for posts by topic, inspect comment threads, or build a shortlist of links to review and reply to manually.

Security Scan

The skill implements read-only Reddit browsing using public reddit.com JSON endpoints, requires only Node (18+), and its code, instructions, and env vars align with the stated purpose.

Purpose & Capability

Name/description (read-only Reddit browsing) matches the actual code and runtime needs: the script fetches from https://www.reddit.com, normalizes posts/comments, and outputs JSON. Declared required binary 'node' is appropriate.

Instruction Scope

SKILL.md instructs only to run the included Node script against Reddit public JSON endpoints and to return permalinks. Instructions reference only optional pacing/timeouts via REDDIT_RO_* env vars which the script actually honors. There is no guidance to read unrelated files, grab other credentials, or send data to third-party endpoints.

Install Mechanism

No install spec (instruction-only) and the code file is a self-contained Node CLI. Nothing is downloaded or written during install; runtime performs normal HTTPS calls to reddit.com.

Credentials

The skill requires no credentials and declares no config paths. It optionally reads REDDIT_RO_* env vars for rate limiting, timeout, and user-agent—these are proportional to HTTP client behavior and are documented in SKILL.md.

Persistence & Privilege

always is false and the skill does not request persistent system modifications or access to other skills' configs. It simply executes as a CLI script when invoked.

Assessment

This skill appears coherent and limited to read-only Reddit browsing, but before installing note: it requires Node.js 18+ (uses global fetch), will make outbound HTTPS requests to reddit.com, and can be invoked autonomously by the agent (normal default). Optional REDDIT_RO_* env vars control pacing and user-agent — you may set them to be polite or to increase timeouts. If you want extra assurance, inspect the full script (scripts/reddit-readonly.mjs) yourself to confirm there are no additional network hosts or unexpected behavior in the truncated portion, and be aware the agent will receive Reddit data (titles, snippets, permalinks) and may present it to users.

Reddit Readonly

Read-only Reddit browsing for Clawdbot.

What this skill is for

• Finding posts in one or more subreddits (hot/new/top/controversial/rising)
• Searching for posts by query (within a subreddit or across all)
• Pulling a comment thread for context
• Producing a shortlist of permalinks so the user can open Reddit and reply manually

Hard rules

• Read-only only. This skill never posts, replies, votes, or moderates.
• Be polite with requests:
  • Prefer small limits (5–10) first.
  • Expand only if needed.
• When returning results to the user, always include permalinks.

Output format

All commands print JSON to stdout.

• Success: { "ok": true, "data": ... }
• Failure: { "ok": false, "error": { "message": "...", "details": "..." } }

Commands

1) List posts in a subreddit

node {baseDir}/scripts/reddit-readonly.mjs posts <subreddit> \
  --sort hot|new|top|controversial|rising \
  --time day|week|month|year|all \
  --limit 10 \
  --after <token>

2) Search posts

# Search within a subreddit
node {baseDir}/scripts/reddit-readonly.mjs search <subreddit> "<query>" --limit 10

# Search all of Reddit
node {baseDir}/scripts/reddit-readonly.mjs search all "<query>" --limit 10

3) Get comments for a post

# By post id or URL
node {baseDir}/scripts/reddit-readonly.mjs comments <post_id|url> --limit 50 --depth 6

4) Recent comments across a subreddit

node {baseDir}/scripts/reddit-readonly.mjs recent-comments <subreddit> --limit 25

5) Thread bundle (post + comments)

node {baseDir}/scripts/reddit-readonly.mjs thread <post_id|url> --commentLimit 50 --depth 6

6) Find opportunities (multi-subreddit helper)

Use this when the user describes criteria like: "Find posts about X in r/a, r/b, and r/c posted in the last 48 hours, excluding Y".

node {baseDir}/scripts/reddit-readonly.mjs find \
  --subreddits "python,learnpython" \
  --query "fastapi deployment" \
  --include "docker,uvicorn,nginx" \
  --exclude "homework,beginner" \
  --minScore 2 \
  --maxAgeHours 48 \
  --perSubredditLimit 25 \
  --maxResults 10 \
  --rank new

Suggested agent workflow

1. Clarify scope if needed: subreddits + topic keywords + timeframe.
2. Start with find (or posts/search) using small limits.
3. For 1–3 promising items, fetch context via thread.
4. Present the user a shortlist:
   • title, subreddit, score, created time
   • permalink
   • a brief reason why it matched
5. If asked, propose draft reply ideas in natural language, but remind the user to post manually.

Troubleshooting

• If Reddit returns HTML, re-run the command (the script detects this and returns an error).
• If requests fail repeatedly, reduce --limit and/or set slower pacing via env vars:

export REDDIT_RO_MIN_DELAY_MS=800
export REDDIT_RO_MAX_DELAY_MS=1800
export REDDIT_RO_TIMEOUT_MS=25000
export REDDIT_RO_USER_AGENT='script:clawdbot-reddit-readonly:v1.0.0 (personal)'