reddit-warmup

What it does

Systematically build Reddit accounts over a 30-day progression and then promote a configured brand in target subreddits. It manages per-account state locally under ~/.reddit-warmup/<username>/ and enforces one account per browser profile with one proxy. It defines three stages: Days 2-14 lurk (browse and upvote only), Days 15-29 comment (AI-generated comments with limited non-brand posts), and Days 30+ promote (comments plus up to two posts per week). It also supports running multiple accounts sequentially and loading reference files before actions. The skill specifies using browser-act as the sole browser execution tool for all Reddit actions and details required files to load for preflight and stage rules.

How it works

• Before any action, load the required reference files listed in the Phase Router (e.g., references/browser-act-rules.md, references/phase2-preflight.md, stage-specific references).
• Use the browser-act CLI for all Reddit-facing browser, page, publishing, and verification operations, including state checks via commands like browser-act state, get markdown, get title, and taking screenshots or network captures for verification.
• Manage per-account state in local files under ~/.reddit-warmup/<username>/ (config.yaml, progress.json, sub_profiles.json, activity_log.jsonl, etc.). Append to activity logs and update progress.json as needed.
• Enforce the Core Rules such as one account per browser profile per phase, no deletions in the first 30 days, email verification after registration, no DMs or friend requests in the first 30 days, and using headed browser sessions.
• Follow the Three stages with day-by-day behavior: lurk (Days 2-14), comment (Days 15-29), promote (Day 30+). Daily planning and execution are gated by phase-specific reference files and approval policies, with approvals managed via Pending Approval flows.
• The skill includes an explicit EXECUTION RULE to load required reference files before taking any action and to stop if those references cannot be loaded.

When to use it

• Triggered to begin or resume a Reddit account warm-up and brand-promotion cycle, including scenarios to register/take over an account, build credibility from scratch, run automated daily tasks, camp on posts, and run multiple accounts sequentially. The trigger phrases include several variants like reddit warmup, 30-day warmup, start warmup, build reddit karma, reddit brand promotion, reddit automated posting, and others.

What it can touch

• Local state under ~/.reddit-warmup/<username>/ (config.yaml, progress.json, sub_profiles.json, activity_log.jsonl, drafts, pending_approval, evidence, images, last_run.png).
• The allowed tools are claude-code, codex, and cursor as declared in the skill.
• All browser actions must be executed via the browser-act CLI; no alternate browser paths are permitted.

Caveats

• License: MIT
• Hard execution rule requires loading reference files before actions and using browser-act for all browser operations; if loading fails, the agent must stop and log/notify.
• Brand promotion and approval policies are governed by config.yaml.approval_policy and references in references/approval-rules.md.
• Risk: daily runs are constrained to one per scheduler day; approvals are separate event-driven publish flows.