brisyramshere

Reddit Skill — Development skill for Claude Code

Development community

Claude Code Agent Skill for searching and reading Reddit via OAuth2 API.

How to install Reddit Skill

This entry records only its repository, not the path inside it, so there is no exact command to give. Open brisyramshere/reddit-skill and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Reddit Skill does

Claude Code Agent Skill for searching and reading Reddit via OAuth2 API.

Alternatives in Development

Reddit Fetch — Fetches Reddit content via Gemini CLI when WebFetch is blocked or returns 403 errors 6.5k ★
Last30days Skill — Claude Code skill that researches any topic across Reddit + X from the last 30 days, then writes copy-paste-re 4.4k ★
Ccundo — Integrates seamlessly with Claude Code to provide granular undo functionality by reading directly from Claude 1.4k ★

README

Reddit Skill

A [Claude Code Agent Skill](https://support.claude.com/en/articles/12512176-what-are-skills) for searching and reading Reddit content via the Reddit OAuth2 API.

Features

Search - Search posts across all of Reddit or within a specific subreddit, with sort and time range filters
List - Browse subreddit posts by category (hot, new, top, rising, controversial)
Read - Read full post content with nested comment trees (supports standard URLs, share links, and post IDs)
Subreddit Info - View subreddit metadata (subscribers, description, etc.)

Setup

1. Get Reddit API Credentials

Go to reddit.com/prefs/apps
Click "create another app..."
Choose script type
Fill in name and redirect URI (use http://localhost:8080)
Note down your client_id (under the app name) and client_secret

2. Set Environment Variables

export REDDIT_CLIENT_ID="your_client_id"
export REDDIT_CLIENT_SECRET="your_client_secret"

Add these to your `~/.bashrc` or `~/.zshrc` for persistence.

3. Install Dependency

pip install requests

4. Install Skill

Copy or symlink this folder to your Claude Code skills directory:

# Option A: Symlink (recommended, stays in sync with repo)
ln -s /path/to/reddit-skill ~/.claude/skills/reddit-skill

# Option B: Copy
cp -r /path/to/reddit-skill ~/.claude/skills/reddit-skill

Usage

Once installed, just ask Claude naturally:

"搜索 Reddit 上关于 Claude Code 的讨论"
"看看 r/ClaudeAI 最近有什么热帖"
"读一下这个 Reddit 帖子 https://reddit.com/r/..."
"Reddit 上大家怎么看 Cursor vs Claude Code"

Direct Script Usage

You can also run the script directly:

# Search
python3 scripts/reddit_reader.py search "Claude Code tips" --sort hot --time week --limit 15

# List subreddit posts
python3 scripts/reddit_reader.py list r/ClaudeAI --category top --time month --limit 20

# Read a post with comments
python3 scripts/reddit_reader.py rea