⏳ This skill is pending AI review.

Scores will appear once the review pipeline completes.

v1.0.0

reddit-skills

1146345502@1146345502⭐ 16 stars· last commit 6mo ago· 0 open issues

|

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.

β€”/10

// RATINGS

⭐GitHub Stars
⭐⭐ 16 on GitHubGitHub β†—

Growing

🟒ProSkills Score
β€”
πŸ“

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

SkillDescriptionCore Capabilities
reddit-authAuthenticationLogin check, session management
reddit-publishContent PublishingText / link / image post submission
reddit-exploreDiscoverySearch, subreddit browsing, post details, user profiles
reddit-interactSocial InteractionComment, reply, upvote, downvote, save
reddit-content-opsCompound OpsSubreddit 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.

  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 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:

VariableDefaultDescription
REDDIT_BRIDGE_URLws://localhost:9334WebSocket 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

SubcommandDescription
check-loginCheck login status, return username if logged in
delete-cookiesLog out (UI-based logout)
home-feedGet home feed posts
subreddit-feedGet posts from a subreddit (supports sort: hot/new/top/rising)
searchSearch posts (supports sort and time filters)
get-post-detailGet full post content and comments
user-profileGet user profile and recent posts
post-commentComment on a post
reply-commentReply to a specific comment
upvoteUpvote a post
downvoteDownvote a post
save-postSave / unsave a post
submit-textSubmit a text (self) post
submit-linkSubmit a link post
submit-imageSubmit 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

// REPO STATS

16 stars
0 open issues
Last commit: 6mo ago