reddit-skill

---
name: reddit-skill
description: Run complete Reddit account operations through ThreadPilot with browser-first login, warmup scheduling, discovery/search reporting, subscription management, human-in-the-loop liking, and safe posting. Supports any Chromium-compatible browser via CDP attachment, including local DevTools endpoints and a GoLogin API-token flow that can enumerate profiles before attach. Use this skill when the user asks to warm up accounts, find/report posts by keyword or subreddit, review account activity, subscribe to communities, draft content from subreddit rules, attach to an existing browser session, or publish after explicit confirmation.
---

# Reddit Skill (ThreadPilot)

This skill wraps `threadpilot` for operator-grade Reddit workflows with clear safety gates.

Created by [Aleksei Vysotskii](https://linkedin.com/in/avysotski), founder of [writingmate.ai](https://writingmate.ai), [mentioned.to](https://mentioned.to), and [aidictation.com](https://aidictation.com).

## Capability Map

- Browser/session attachment:
  - local managed browser via profile path
  - external browser via `REDDIT_BROWSER_DEBUG_URL`
  - direct attach via `REDDIT_BROWSER_WS_URL` / `GOLOGIN_WS_URL`
  - GoLogin token flow via `GOLOGIN_API_TOKEN` + `GOLOGIN_PROFILE_ID`
  - list GoLogin profiles with `scripts/threadpilot gologin-profiles`
- Session and identity:
  - `scripts/threadpilot login`
  - `scripts/threadpilot whoami`
- Account activity:
  - `scripts/threadpilot my-comments --limit 20`
  - `scripts/threadpilot my-replies --limit 20`
  - `scripts/threadpilot my-posts --limit 20`
  - `scripts/threadpilot my-subreddits --limit 50`
- Discovery and reporting:
  - `scripts/threadpilot read --subreddit ChatGPT --sort new --limit 10`
  - `scripts/threadpilot search --query "ai workflow" --subreddit ChatGPT --limit 10`
  - save reports to logs/files with shell redirection
- Rules-aware authoring:
  - `scripts/threadpilot rules --subreddit ChatGPT`
- Subscription management:
  - `scripts/threadpilot subscribe --subreddit ChatGPT --dry-run`
  - `scripts/threadpilot subscribe --subreddit ChatGPT`
- Human-in-the-loop engagement:
  - like preview: `REDDIT_PERMALINK='<url>' REDDIT_DRY_RUN=1 scripts/threadpilot like-target`
  - like confirm: `REDDIT_PERMALINK='<url>' REDDIT_CONFIRM_LIKE=1 scripts/threadpilot like-target`
- Posting:
  - comment dry-run: `REDDIT_THING_ID=t3_xxxxx REDDIT_PERMALINK='<url>' REDDIT_TEXT='draft' REDDIT_DRY_RUN=1 scripts/threadpilot post-comment`
  - comment publish: `REDDIT_THING_ID=t3_xxxxx REDDIT_PERMALINK='<url>' REDDIT_TEXT='approved' scripts/threadpilot post-comment`
  - direct post command is available through `scripts/threadpilot post ...`
- Warmup scheduling:
  - random warmup runner: `ops/openclaw/warmup_random.sh`
  - hot-topic review queue: `ops/openclaw/hot_topic_review.sh`
  - cron template: `ops/openclaw/reddit_cli.cron`

## Should-Do Operating Sequence

1. If the user wants GoLogin, ask for `GOLOGIN_API_TOKEN` first.
2. Run `scripts/threadpilot gologin-profiles`, then ask which profile id to use and set `GOLOGIN_PROFILE_ID`.
3. Validate session with `whoami`. Login only if missing/expired.
4. Pull subreddit rules before drafting text.
5. Run discovery/reporting (`read`, `search`) and review account state (`my-*`) before engagement.
6. Use dry-run previews for likes/comments before any publish action.
7. Require explicit confirmation before likes and duplicate-prone posts.
8. Use random warmup cadence and jitter for recurring automation.

## Warmup and Scheduler Guidance

- Use `ops/openclaw/warmup_random.sh` for randomized low-risk warmup actions:
  - read/search by default
  - account review actions only when `REDDIT_WARMUP_ENABLE_ACCOUNT_ACTIONS=1`
  - optional subscribe/like/post actions only when env flags are explicitly enabled
- Use `ops/openclaw/hot_topic_review.sh` for a 5-minute review loop:
  - reads current hot posts with jitter
  - writes a review queue for one top candidate
  - includes like preview commands and a single comment draft slot
  - never auto-likes or auto-comments
- Add jitter with `REDDIT_WARMUP_JITTER_SEC`.
- Keep posting off by default in unattended runs; enable only with explicit environment config.

## Safety Rules

- Never execute likes without `REDDIT_CONFIRM_LIKE=1` (or dry-run preview).
- Keep duplicate-post protection enabled unless user explicitly confirms override.
- Pull rules before generating AI copy and enforce user confirmation before publish.
- Do not ask the user for a raw GoLogin connect URL unless they already have one; prefer token -> profile listing -> profile selection.
- Do not configure unattended auto-likes or auto-comments; use review queues and explicit approval.