reddit-skills

---
name: reddit-skills
description: Use when the user asks to operate Reddit across authentication, search, publishing, comments, votes, saves, subreddit analysis, or multi-step content workflows.
tags: [reddit, automation, social-media]
capability: Coordinate Reddit search, publish, comment, login, vote, and save tasks across multiple skills.
triggers:
  - use Reddit
  - operate Reddit
  - Reddit workflow
  - several Reddit actions
  - Search Reddit, then comment
  - Browse a subreddit and save a post
  - Check Reddit login and publish a link post
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.

## Example: 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
```

Inspect a post and publish a response:

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

Interact with the published content:

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

• .gitignore 1 KB
• CONTRIBUTING.md 2 KB
• Dockerfile 1 KB
• LICENSE 1 KB
• README.md 5 KB
• SKILL.md 6 KB
• pyproject.toml 1 KB
• uv.lock 50 KB
• extension/background.js 6 KB
• extension/dom_commands.js 7 KB
• extension/manifest.json 1 KB
• scripts/bridge_server.py 4 KB
• scripts/cli.py 17 KB
• scripts/image_downloader.py 2 KB
• scripts/mcp_server.py 10 KB
• scripts/reddit/__init__.py 1 KB
• scripts/reddit/bridge.py 8 KB
• scripts/reddit/comment.py 7 KB
• scripts/reddit/errors.py 1 KB
• scripts/reddit/feeds.py 3 KB
• scripts/reddit/human.py 1 KB
• scripts/reddit/login.py 4 KB
• scripts/reddit/post_detail.py 5 KB
• scripts/reddit/publish.py 16 KB
• scripts/reddit/search.py 3 KB
• scripts/reddit/selectors.py 1 KB
• scripts/reddit/types.py 7 KB
• scripts/reddit/urls.py 1 KB
• scripts/reddit/user_profile.py 5 KB
• scripts/reddit/vote.py 4 KB
• skills/reddit-auth/SKILL.md 3 KB
• skills/reddit-content-ops/SKILL.md 5 KB
• skills/reddit-explore/SKILL.md 4 KB
• skills/reddit-explore/skills-reddit-v1.9.zip 456 KB
• skills/reddit-interact/SKILL.md 4 KB
• skills/reddit-publish/SKILL.md 5 KB