Reddit Reader

What it does

Reddit Reader lets an agent search Reddit, list subreddit posts, and read full posts and nested comments using Reddit's OAuth2 API. It produces structured Markdown output suitable for summarisation, trend analysis, and extracting community viewpoints. The skill includes command-line scripts to run searches, list subreddit feeds, and fetch post+comment trees.

When to use it

Use this skill when a user asks to: search Reddit for discussions about a topic, inspect recent subreddit posts, read a specific Reddit post and its comments, or summarise community sentiment on an issue. It supports filters for time ranges, sorting (hot/new/top), and limits.

What's included

• Scripts: usage examples and command-line invocations are documented in the skill body (scripts/reddit_reader.py).
• References: none bundled in this repo.
• Instructions: prerequisites (REDDIT_CLIENT_ID, REDDIT_CLIENT_SECRET), example commands for search/list/read/subreddit, and output formatting guidance.

Compatible agents

Primarily Python-based agent integrations (Claude Code, Copilot-style agents, or any agent that can run Python scripts and read structured Markdown).