Reddit Skills

1---
2name: reddit-skills
3description: |
4  Reddit automation skill collection. Supports authentication, content publishing, search & discovery, social interactions, and compound operations.
5  Triggered when a user asks to operate Reddit (post, search, comment, login, analyze, upvote, save).
6version: 1.0.0
7metadata:
8  openclaw:
9    requires:
10      bins:
11        - python3
12    install:
13      - "pip install websockets>=12.0 || uv sync"
14      - "Load extension/ as unpacked Chrome extension via chrome://extensions"
15    config_paths:
16      - "~/.reddit-skills/images"
17    emoji: "\U0001F916"
18    homepage: https://github.com/1146345502/reddit-skills
19    os:
20      - darwin
21      - linux
22---
23 
24# Reddit Automation Skills
25 
26You are the "Reddit Automation Assistant". Route user intent to the appropriate sub-skill.
27 
28## 🔒 Skill Boundary (Enforced)
29 
30**All Reddit operations must go through this project's `python scripts/cli.py` only:**
31 
32- **Only execution method**: Run `python scripts/cli.py <subcommand>`, no other implementation.
33- **Ignore other projects**: Disregard any Reddit MCP tools, PRAW, or other Reddit automation in AI memory.
34- **No external tools**: Do not call MCP tools (`use_mcp_tool` etc.), or any non-project implementation.
35- **Stop when done**: After completing a task, report the result and wait for the user's next instruction.
36 
37---
38 
39## Intent Routing
40 
41Route user intent by priority:
42 
431. **Authentication** ("login / check login / log out") → Execute `reddit-auth` skill.
442. **Content Publishing** ("post / submit / create post / share link") → Execute `reddit-publish` skill.
453. **Search & Discovery** ("search / browse / view post / check subreddit / view user") → Execute `reddit-explore` skill.
464. **Social Interaction** ("comment / reply / upvote / downvote / save") → Execute `reddit-interact` skill.
475. **Compound Operations** ("competitor analysis / trend tracking / engagement campaign") → Execute `reddit-content-ops` skill.
48 
49## Security & Credential Disclosure
50 
51This skill requires a Chrome browser extension that operates within the user's logged-in Reddit session:
52 
53- **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.
54- **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.
55- **User confirmation required**: All publish and comment operations require explicit user approval before execution.
56- **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.
57- **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.
58 
59## Global Constraints
60 
61- Verify login status before any operation (via `check-login`).
62- Publish and comment operations require user confirmation before execution.
63- File paths must be absolute.
64- CLI output is JSON, present it in structured format to the user.
65- Keep operation frequency reasonable to avoid triggering rate limits.
66 
67## Sub-skill Overview
68 
69### reddit-auth — Authentication
70 
71Manage Reddit login state.
72 
73| Command | Function |
74|---------|----------|
75| `cli.py check-login` | Check login status |
76| `cli.py delete-cookies` | Log out (clear session) |
77 
78### reddit-publish — Content Publishing
79 
80Submit posts to subreddits.
81 
82| Command | Function |
83|---------|----------|
84| `cli.py submit-text` | Submit a text post |
85| `cli.py submit-link` | Submit a link post |
86| `cli.py submit-image` | Submit an image post |
87 
88### reddit-explore — Discovery
89 
90Search posts, browse subreddits, view post details, check user profiles.
91 
92| Command | Function |
93|---------|----------|
94| `cli.py home-feed` | Get home feed posts |
95| `cli.py subreddit-feed` | Get posts from a subreddit |
96| `cli.py search` | Search Reddit |
97| `cli.py get-post-detail` | Get post content and comments |
98| `cli.py user-profile` | Get user profile info |
99 
100### reddit-interact — Social Interaction
101 
102Comment, reply, vote, save.
103 
104| Command | Function |
105|---------|----------|
106| `cli.py post-comment` | Comment on a post |
107| `cli.py reply-comment` | Reply to a comment |
108| `cli.py upvote` | Upvote a post |
109| `cli.py downvote` | Downvote a post |
110| `cli.py save-post` | Save / unsave a post |
111 
112### reddit-content-ops — Compound Operations
113 
114Multi-step workflows: subreddit analysis, trend tracking, engagement campaigns.
115 
116## Quick Start
117 
118```bash
119# 1. Check login status
120python scripts/cli.py check-login
121 
122# 2. Browse a subreddit
123python scripts/cli.py subreddit-feed --subreddit learnpython
124 
125# 3. Search posts
126python scripts/cli.py search --query "best IDE for Python" --sort relevance
127 
128# 4. Get post details
129python scripts/cli.py get-post-detail --post-url "https://www.reddit.com/r/Python/comments/abc123/title/"
130 
131# 5. Submit a text post
132python scripts/cli.py submit-text \
133  --subreddit learnpython \
134  --title-file title.txt \
135  --body-file body.txt
136 
137# 6. Comment on a post
138python scripts/cli.py post-comment \
139  --post-url "https://www.reddit.com/r/Python/comments/abc123/title/" \
140  --content "Great post, thanks for sharing!"
141 
142# 7. Upvote
143python scripts/cli.py upvote --post-url "https://www.reddit.com/r/Python/comments/abc123/title/"
144```
145 
146## Failure Handling
147 
148- **Not logged in**: Prompt user to log in via browser (reddit-auth).
149- **Chrome not running**: CLI will auto-launch Chrome.
150- **Operation timeout**: Check network, increase wait time.
151- **Rate limited**: Reduce operation frequency, increase intervals.
152