β³ This skill is pending AI review.
Scores will appear once the review pipeline completes.
reddit-skills
|
Choose how to use this skill
You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.
1. Native installer
This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.
Do not guess an installer command or replace an existing version without reviewing the diff.
2. Complete package recommended
Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.
No complete ProSkills package is published for this listing yet.3. Prompt-only
Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.
Need only the instruction file?
Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.
No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.
// RATINGS
Not yet listed on ClawHub or SkillsMP
// README
reddit-skills
Reddit automation Skills β directly uses your logged-in browser and real account, operating Reddit as an ordinary user.
Supports OpenClaw and all AI Agent platforms compatible with the SKILL.md format (e.g. Claude Code).
β οΈ Usage advice: Although this project uses your real browser and account, you should still control operation frequency and avoid mass actions in a short time. Aggressive automation may trigger Reddit's rate limits or account restrictions.
Features
| Skill | Description | Core Capabilities |
|---|---|---|
| reddit-auth | Authentication | Login check, session management |
| reddit-publish | Content Publishing | Text / link / image post submission |
| reddit-explore | Discovery | Search, subreddit browsing, post details, user profiles |
| reddit-interact | Social Interaction | Comment, reply, upvote, downvote, save |
| reddit-content-ops | Compound Ops | Subreddit analysis, trend tracking, engagement campaigns |
Supports chained operations β you can give compound natural-language instructions and the Agent will automatically chain multiple skills. For example:
"Search r/Python for the most upvoted posts about FastAPI this week, save the top one, and tell me what it's about"
The Agent will execute: search β filter by top/week β save β get detail β summarize.
Installation
Prerequisites
- Python >= 3.11
- uv package manager
- Google Chrome browser
Step 1: Install the project
Option A: Download ZIP (recommended)
Download from GitHub and extract to your Agent skills directory:
# OpenClaw
<openclaw-project>/skills/reddit-skills/
# Claude Code
<your-project>/.claude/skills/reddit-skills/
Option B: Git Clone
cd <your-agent-project>/skills/
git clone https://github.com/1146345502/reddit-skills.git
Then install Python dependencies:
cd reddit-skills
uv sync
Step 2: Install the browser extension
The extension lets the AI operate Reddit in your browser using your real login session.
- Open Chrome, navigate to
chrome://extensions/ - Enable Developer mode (top right)
- Click Load unpacked, select this project's
extension/directory - Confirm the Reddit Bridge extension is enabled
Once installed, you're ready to go β all actions happen in your own browser, using your real account.
Usage
As an AI Agent skill (recommended)
After installing to a skills directory, just talk to the Agent in natural language. It will route your intent to the right skill automatically.
Authentication:
"Check if I'm logged in to Reddit" / "Log out of Reddit"
Search & Browse:
"Search Reddit for posts about machine learning" / "Show me the top posts on r/Python"
Submit content:
"Submit a text post to r/learnpython with this title and body..."
Interact:
"Upvote this post" / "Comment on this post: Great write-up!" / "Save this post"
Compound operations:
"Analyze the top posts in r/startups this month and summarize the common themes"
As an MCP server
reddit-skills includes a built-in Model Context Protocol server, making it compatible with any MCP client (Claude Desktop, Cursor, etc.).
Start the server (stdio):
cd reddit-skills
python scripts/mcp_server.py
Configure in your MCP client (e.g. Claude Desktop claude_desktop_config.json):
{
"mcpServers": {
"reddit-skills": {
"command": "python",
"args": ["scripts/mcp_server.py"],
"cwd": "/path/to/reddit-skills"
}
}
}
The server exposes 16 tools: check_login, logout, home_feed, subreddit_feed, search, get_post_detail, user_profile, subreddit_rules, post_comment, reply_comment, upvote, downvote, save_post, submit_text_post, submit_link_post, submit_image_post.
Environment variables:
| Variable | Default | Description |
|---|---|---|
REDDIT_BRIDGE_URL | ws://localhost:9334 | WebSocket URL for the bridge server |
As a CLI tool
All features can be called directly from the command line, with JSON output for scripting.
# Check login status
python scripts/cli.py check-login
# Browse a subreddit
python scripts/cli.py subreddit-feed --subreddit python --sort hot
# Search posts
python scripts/cli.py search --query "FastAPI tutorial" --sort top --time month
# Get post details and comments
python scripts/cli.py get-post-detail \
--post-url "https://www.reddit.com/r/Python/comments/abc123/title/"
# Submit a text post
python scripts/cli.py submit-text \
--subreddit learnpython \
--title-file title.txt \
--body-file body.txt
# Submit a link post
python scripts/cli.py submit-link \
--subreddit programming \
--title-file title.txt \
--url "https://example.com/article"
# Submit an image post
python scripts/cli.py submit-image \
--subreddit pics \
--title-file title.txt \
--images "/abs/path/image.jpg"
# Comment on a post
python scripts/cli.py post-comment \
--post-url "https://www.reddit.com/r/Python/comments/abc123/title/" \
--content "Thanks for sharing!"
# Upvote / Downvote / Save
python scripts/cli.py upvote --post-url "https://www.reddit.com/r/..."
python scripts/cli.py downvote --post-url "https://www.reddit.com/r/..."
python scripts/cli.py save-post --post-url "https://www.reddit.com/r/..."
# View user profile
python scripts/cli.py user-profile --username spez
On first run, if Chrome is not open, the CLI will auto-launch it.
CLI Command Reference
| Subcommand | Description |
|---|---|
check-login | Check login status, return username if logged in |
delete-cookies | Log out (UI-based logout) |
home-feed | Get home feed posts |
subreddit-feed | Get posts from a subreddit (supports sort: hot/new/top/rising) |
search | Search posts (supports sort and time filters) |
get-post-detail | Get full post content and comments |
user-profile | Get user profile and recent posts |
post-comment | Comment on a post |
reply-comment | Reply to a specific comment |
upvote | Upvote a post |
downvote | Downvote a post |
save-post | Save / unsave a post |
submit-text | Submit a text (self) post |
submit-link | Submit a link post |
submit-image | Submit an image post |
Exit codes: 0 success Β· 1 not logged in Β· 2 error
Project Structure
reddit-skills/
βββ extension/ # Chrome Extension (MV3)
β βββ manifest.json
β βββ background.js
βββ scripts/ # Python automation engine
β βββ reddit/ # Core automation library
β β βββ bridge.py # Extension bridge client
β β βββ selectors.py # CSS selectors (centralized)
β β βββ login.py # Login check + logout
β β βββ feeds.py # Home feed + subreddit feed
β β βββ search.py # Search + filters
β β βββ post_detail.py # Post detail + comment loading
β β βββ user_profile.py # User profile
β β βββ comment.py # Comment, reply
β β βββ vote.py # Upvote, downvote, save
β β βββ publish.py # Post submission
β β βββ types.py # Data types
β β βββ errors.py # Exception hierarchy
β β βββ urls.py # URL constants
β β βββ human.py # Behavior simulation
β βββ cli.py # Unified CLI entry point
β βββ mcp_server.py # MCP server wrapper (stdio/HTTP)
β βββ bridge_server.py # Local WebSocket bridge
β βββ image_downloader.py # Image download with local cache
βββ skills/ # AI Agent skill definitions
β βββ reddit-auth/SKILL.md
β βββ reddit-publish/SKILL.md
β βββ reddit-explore/SKILL.md
β βββ reddit-interact/SKILL.md
β βββ reddit-content-ops/SKILL.md
βββ SKILL.md
// HOW IT'S BUILT
// FILES
2 files shipped with this skill. Inline text is the catalog copy. The upstream link is the source repository.
SKILL.md5.9 KBupstream β
--- name: reddit-skills description: | Reddit automation skill collection. Supports authentication, content publishing, search & discovery, social interactions, and compound operations. Triggered when a user asks to operate Reddit (post, search, comment, login, analyze, upvote, save). version: 1.0.0 metadata: openclaw: requires: bins: - python3 install: - "pip install websockets>=12.0 || uv sync" - "Load extension/ as unpacked Chrome extension via chrome://extensions" config_paths: - "~/.reddit-skills/images" emoji: "\U0001F916" homepage: https://github.com/1146345502/reddit-skills os: - darwin - linux --- # Reddit Automation Skills You are the "Reddit Automation Assistant". Route user intent to the appropriate sub-skill. ## π Skill Boundary (Enforced) **All Reddit operations must go through this project's `python scripts/cli.py` only:** - **Only execution method**: Run `python scripts/cli.py <subcommand>`, no other implementation. - **Ignore other projects**: Disregard any Reddit MCP tools, PRAW, or other Reddit automation in AI memory. - **No external tools**: Do not call MCP tools (`use_mcp_tool` etc.), or any non-project implementation. - **Stop when done**: After completing a task, report the result and wait for the user's next instruction. --- ## Intent Routing Route user intent by priority: 1. **Authentication** ("login / check login / log out") β Execute `reddit-auth` skill. 2. **Content Publishing** ("post / submit / create post / share link") β Execute `reddit-publish` skill. 3. **Search & Discovery** ("search / browse / view post / check subreddit / view user") β Execute `reddit-explore` skill. 4. **Social Interaction** ("comment / reply / upvote / downvote / save") β Execute `reddit-interact` skill. 5. **Compound Operations** ("competitor analysis / trend tracking / engagement campaign") β Execute `reddit-content-ops` skill. ## Security & Credential Disclosure This skill requires a Chrome browser extension that operates within the user's logged-in Reddit session: - **Implicit credential**: The extension accesses your Reddit session via browser cookies. No API keys or environment variables are needed, but your active login session is used. - **Browser permissions**: The extension uses `cookies`, `debugger`, `scripting`, and `activeTab` permissions scoped to reddit.com domains only. See `extension/manifest.json` for the full permission list. - **User confirmation required**: All publish and comment operations require explicit user approval before execution. - **Network scope**: The extension (`background.js`) connects only to `ws://localhost:9334`. The Python bridge server (`bridge_server.py`) binds to `127.0.0.1:9334`. Image downloads (`image_downloader.py`) fetch user-specified URLs via stdlib `urllib.request` and cache to `~/.reddit-skills/images`. No other outbound network calls are made. Verify by inspecting the three files listed above. - **Data flow**: CLI reads Reddit page content via the extension, outputs JSON to stdout. Downloaded images are cached locally. No data is sent to third-party analytics, telemetry, or remote servers. ## Global Constraints - Verify login status before any operation (via `check-login`). - Publish and comment operations require user confirmation before execution. - File paths must be absolute. - CLI output is JSON, present it in structured format to the user. - Keep operation frequency reasonable to avoid triggering rate limits. ## Sub-skill Overview ### reddit-auth β Authentication Manage Reddit login state. | Command | Function | |---------|----------| | `cli.py check-login` | Check login status | | `cli.py delete-cookies` | Log out (clear session) | ### reddit-publish β Content Publishing Submit posts to subreddits. | Command | Function | |---------|----------| | `cli.py submit-text` | Submit a text post | | `cli.py submit-link` | Submit a link post | | `cli.py submit-image` | Submit an image post | ### reddit-explore β Discovery Search posts, browse subreddits, view post details, check user profiles. | Command | Function | |---------|----------| | `cli.py home-feed` | Get home feed posts | | `cli.py subreddit-feed` | Get posts from a subreddit | | `cli.py search` | Search Reddit | | `cli.py get-post-detail` | Get post content and comments | | `cli.py user-profile` | Get user profile info | ### reddit-interact β Social Interaction Comment, reply, vote, save. | Command | Function | |---------|----------| | `cli.py post-comment` | Comment on a post | | `cli.py reply-comment` | Reply to a comment | | `cli.py upvote` | Upvote a post | | `cli.py downvote` | Downvote a post | | `cli.py save-post` | Save / unsave a post | ### reddit-content-ops β Compound Operations Multi-step workflows: subreddit analysis, trend tracking, engagement campaigns. ## Quick Start ```bash # 1. Check login status python scripts/cli.py check-login # 2. Browse a subreddit python scripts/cli.py subreddit-feed --subreddit learnpython # 3. Search posts python scripts/cli.py search --query "best IDE for Python" --sort relevance # 4. Get post details python scripts/cli.py get-post-detail --post-url "https://www.reddit.com/r/Python/comments/abc123/title/" # 5. Submit a text post python scripts/cli.py submit-text \ --subreddit learnpython \ --title-file title.txt \ --body-file body.txt # 6. Comment on a post python scripts/cli.py post-comment \ --post-url "https://www.reddit.com/r/Python/comments/abc123/title/" \ --content "Great post, thanks for sharing!" # 7. Upvote python scripts/cli.py upvote --post-url "https://www.reddit.com/r/Python/comments/abc123/title/" ``` ## Failure Handling - **Not logged in**: Prompt user to log in via browser (reddit-auth). - **Chrome not running**: CLI will auto-launch Chrome. - **Operation timeout**: Check network, increase wait time. - **Rate limited**: Reduce operation frequency, increase intervals.README.mdupstream β
Contents are not inlined in the catalog. Open the upstream file.
Plain-text copy, no login: /skill-bundles/1146345502-reddit-skills.md