# reddit-skills

Adopt this skill: https://proskills.md/skills/other/1146345502-reddit-skills

Page: https://proskills.md/skills/other/1146345502-reddit-skills
This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required.

## File: SKILL.md
size: 6001
upstream: https://github.com/1146345502/reddit-skills/blob/HEAD/SKILL.md

````text
---
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.
````

## File: README.md
upstream: https://github.com/1146345502/reddit-skills/blob/HEAD/README.md

````text
# 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](https://docs.astral.sh/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**

```bash
cd <your-agent-project>/skills/
git clone https://github.com/1146345502/reddit-skills.git
```

Then install Python dependencies:

```bash
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.

1. Open Chrome, navigate to `chrome://extensions/`
2. Enable **Developer mode** (top right)
3. Click **Load unpacked**, select this project's `extension/` directory
4. 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](https://modelcontextprotocol.io) server, making it compatible with any MCP client (Claude Desktop, Cursor, etc.).

**Start the server (stdio):**

```bash
cd reddit-skills
python scripts/mcp_server.py
```

**Configure in your MCP client** (e.g. Claude Desktop `claude_desktop_config.json`):

```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.

```bash
# 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     
````
