How do I install the Reddit skill?

Run npx skillmds@latest add alekseiul/reddit in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Reddit safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Reddit?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Reddit free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Reddit?

AlekseiUL (@alekseiul) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Reddit by alekseiul — Agent Skill

Name: Reddit
Author: AlekseiUL

Browse, search, post, and moderate Reddit. Read-only works without auth; posting/moderation requires OAuth setup. Use when user mentions Reddit, wants to search subreddits, read threads, or post on Reddit. Triggers on 'reddit', 'subreddit', 'реддит'.

AlekseiUL 1f3ec93 2 files · 19.0 KB Updated Sep 17, 2026

File contents

Browse, search, post to, and moderate subreddits. Read-only actions work without auth; posting/moderation requires OAuth setup.

Setup (for posting/moderation)

Go to https://www.reddit.com/prefs/apps
Click "create another app..."
Select "script" type
Set redirect URI to http://localhost:8080
Note your client ID (under app name) and client secret

Set environment variables:

export REDDIT_CLIENT_ID="your_client_id"
export REDDIT_CLIENT_SECRET="your_client_secret"
export REDDIT_USERNAME="your_username"
export REDDIT_PASSWORD="your_password"

Read Posts (no auth required)

# Hot posts from a subreddit
node {baseDir}/scripts/reddit.mjs posts wallstreetbets

# New posts
node {baseDir}/scripts/reddit.mjs posts wallstreetbets --sort new

# Top posts (day/week/month/year/all)
node {baseDir}/scripts/reddit.mjs posts wallstreetbets --sort top --time week

# Limit results
node {baseDir}/scripts/reddit.mjs posts wallstreetbets --limit 5

Search Posts

# Search within a subreddit
node {baseDir}/scripts/reddit.mjs search wallstreetbets "YOLO"

# Search all of Reddit
node {baseDir}/scripts/reddit.mjs search all "stock picks"

Get Comments on a Post

# By post ID or full URL
node {baseDir}/scripts/reddit.mjs comments POST_ID
node {baseDir}/scripts/reddit.mjs comments "https://reddit.com/r/subreddit/comments/abc123/..."

Submit a Post (requires auth)

# Text post
node {baseDir}/scripts/reddit.mjs submit yoursubreddit --title "Weekly Discussion" --text "What's on your mind?"

# Link post
node {baseDir}/scripts/reddit.mjs submit yoursubreddit --title "Great article" --url "https://example.com/article"

Reply to a Post/Comment (requires auth)

node {baseDir}/scripts/reddit.mjs reply THING_ID "Your reply text here"

Moderation (requires auth + mod permissions)

# Remove a post/comment
node {baseDir}/scripts/reddit.mjs mod remove THING_ID

# Approve a post/comment
node {baseDir}/scripts/reddit.mjs mod approve THING_ID

# Sticky a post
node {baseDir}/scripts/reddit.mjs mod sticky POST_ID

# Unsticky
node {baseDir}/scripts/reddit.mjs mod unsticky POST_ID

# Lock comments
node {baseDir}/scripts/reddit.mjs mod lock POST_ID

# View modqueue
node {baseDir}/scripts/reddit.mjs mod queue yoursubreddit

Notes

Read actions use Reddit's public JSON API (no auth needed)
Post/mod actions require OAuth - run login command once to authorize
Token stored at ~/.reddit-token.json (auto-refreshes)
Rate limits: ~60 requests/minute for OAuth, ~10/minute for unauthenticated

---name: redditdescription: Browse, search, post, and moderate Reddit. Read-only works without auth; posting/moderation requires OAuth setup. Use when user mentions Reddit, wants to search subreddits, read threads, or post on Reddit. Triggers on 'reddit', 'subreddit', 'реддит'.---# RedditBrowse, search, post to, and moderate subreddits. Read-only actions work without auth; posting/moderation requires OAuth setup.## Setup (for posting/moderation)1. Go to https://www.reddit.com/prefs/apps2. Click "create another app..."3. Select "script" type4. Set redirect URI to `http://localhost:8080`5. Note your client ID (under app name) and client secret6. Set environment variables: ```bash export REDDIT_CLIENT_ID="your_client_id" export REDDIT_CLIENT_SECRET="your_client_secret" export REDDIT_USERNAME="your_username" export REDDIT_PASSWORD="your_password" ```## Read Posts (no auth required)```bash# Hot posts from a subredditnode {baseDir}/scripts/reddit.mjs posts wallstreetbets# New postsnode {baseDir}/scripts/reddit.mjs posts wallstreetbets --sort new# Top posts (day/week/month/year/all)node {baseDir}/scripts/reddit.mjs posts wallstreetbets --sort top --time week# Limit resultsnode {baseDir}/scripts/reddit.mjs posts wallstreetbets --limit 5```## Search Posts```bash# Search within a subredditnode {baseDir}/scripts/reddit.mjs search wallstreetbets "YOLO"# Search all of Redditnode {baseDir}/scripts/reddit.mjs search all "stock picks"```## Get Comments on a Post```bash# By post ID or full URLnode {baseDir}/scripts/reddit.mjs comments POST_IDnode {baseDir}/scripts/reddit.mjs comments "https://reddit.com/r/subreddit/comments/abc123/..."```## Submit a Post (requires auth)```bash# Text postnode {baseDir}/scripts/reddit.mjs submit yoursubreddit --title "Weekly Discussion" --text "What's on your mind?"# Link postnode {baseDir}/scripts/reddit.mjs submit yoursubreddit --title "Great article" --url "https://example.com/article"```## Reply to a Post/Comment (requires auth)```bashnode {baseDir}/scripts/reddit.mjs reply THING_ID "Your reply text here"```## Moderation (requires auth + mod permissions)```bash# Remove a post/commentnode {baseDir}/scripts/reddit.mjs mod remove THING_ID# Approve a post/commentnode {baseDir}/scripts/reddit.mjs mod approve THING_ID# Sticky a postnode {baseDir}/scripts/reddit.mjs mod sticky POST_ID# Unstickynode {baseDir}/scripts/reddit.mjs mod unsticky POST_ID# Lock commentsnode {baseDir}/scripts/reddit.mjs mod lock POST_ID# View modqueuenode {baseDir}/scripts/reddit.mjs mod queue yoursubreddit```## Notes- Read actions use Reddit's public JSON API (no auth needed)- Post/mod actions require OAuth - run `login` command once to authorize- Token stored at `~/.reddit-token.json` (auto-refreshes)- Rate limits: ~60 requests/minute for OAuth, ~10/minute for unauthenticated

Frequently asked questions

Reddit