Agent skill · writing content · tristanmanchester
reddit-readonly
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.
Why this skill is useful
Adds specific commands and workflows for interacting with Reddit's public JSON endpoints that the AI wouldn't reliably generate on its own.
What it needs
Requires node installed locally. About 2k tokens when loaded. Last updated 2026-06-29. 3 stars on the source repository.
What this skill does
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 2) Search posts 3) Get comments for a post 4) Recent comments across a subreddit 5) Thread bundle (post + comments) 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". 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:
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills tristanmanchester/reddit