auto-commenter README

The project's README from github.com/rokpiy/auto-commenter. As one markdown file: README.md.

Auto-Commenter

Auto-Commenter - A Claude skill that automatically posts personalized, authentic comments in your target communities

License: MIT PRs Welcome

Follow on X Join Discord

A marketing automation framework using Claude Skills and Playwright MCP for authentic community engagement. Features personalized comment generation, target community selection, daily tracking, batch execution, and lead identification.

Currently supports Reddit — easily extensible to Twitter, LinkedIn, Discord, and other platforms by adding personalization files.

What is This?

Auto-Commenter is a Claude AI skill that:

Unlike typical bots that produce obvious automated comments, this system replicates your unique voice and provides genuine value.

Quick Start

1. Installation

git clone https://github.com/rokpiy/auto-commenter.git
cd auto-commenter
npm install

2. Configure Your Style

Create personalization file:

  1. Collect 8-10 comments you've written (various topics, lengths, tones)
  2. Ask your LLM: "Analyze these comments and create a personalization guide"
  3. Paste the result into .claude/skills/reddit-commenter/resources/personalization_reddit.md

3. Customize Target Communities

Configure subreddits:

  1. Ask your LLM to analyze your target subreddits
  2. Paste community rules, tone, and good topics into .claude/skills/reddit-commenter/resources/subreddits.md

Optional - Add product info:

4. Run

Single comment:

"Write one comment on r/YourSubreddit"

Batch mode (fill daily quota):

"Fill today's quota"

Detailed setup: See SETUP.md

Project Structure

auto-commenter/
├── .claude/skills/reddit-commenter/
│   ├── SKILL.md                      # Single comment workflow
│   ├── BATCH.md                      # Batch mode execution
│   └── resources/
│       ├── personalization_reddit.md # YOUR writing style (customize this)
│       ├── subreddits.md             # Target community analysis
│       └── product.md                # Your product info (optional)
├── tracking/reddit/                  # Daily activity logs
├── leads/reddit.md                   # Discovered potential customers
├── SETUP.md                          # Detailed setup guide
└── CONTRIBUTING.md                   # Contribution guidelines

Key Features

Usage

Single Comment

"Write one comment on r/ClaudeAI"

→ Analyzes posts, writes in your style, reviews quality, posts, tracks

Batch Mode

"Fill today's quota"

→ Fills all subreddit quotas (default: 3 per subreddit, 5-15 min intervals)

Check Activity

"Show today's Reddit activity"

→ View tracking file: tracking/reddit/2026-01-30.md

Multi-Platform Support

Currently supports Reddit. To add other platforms:

  1. Copy .claude/skills/reddit-commenter/ → .claude/skills/[platform]-commenter/
  2. Customize personalization_[platform].md with platform-specific style
  3. Update SKILL.md and BATCH.md for platform APIs/browser automation
  4. Create tracking/[platform]/ and leads/[platform].md

Coming soon: Twitter, LinkedIn, Discord templates

Documentation

Responsible Use

⚠️ This tool enhances genuine engagement, not replaces it.

Do:

Don't:

See Responsible Use Guidelines for details.

License

MIT License - see LICENSE

Built with Claude AI and Playwright MCP

Support

Upgrade Your Agents with Membase

Want to take your AI agents to the next level? Connects memory across all your agents, so they never forget context and always stay in sync.

Join 1,300+ developers personalizing agents

Star History

Star History Chart

auto-commenter (rokpiy/auto-commenter)

Searching Database…

585 ·GitHub
Auto-commenter
What is this?Auto-Commenter is a Claude AI skill that automatically writes and posts personalized Reddit comments, learning your writing style, analyzing post context, and tracking daily quotas across subreddits.
Is this a standalone app or a Claude plugin?It is a Claude Skill — a folder of markdown instructions and resource files that Claude AI/Claude Code runs together with the Playwright MCP server for browser automation, not a separately installed application.
How do I get it running?Install the skill folder, build a personalization file at .claude/skills/reddit-commenter/resources/personalizationreddit.md from 8-10 of your own comments, configure target subreddits in subreddits.md, then run single-comment or batch mode.
What do I need before running it?You need Claude (Claude AI or Claude Code) plus the Playwright MCP server, which drives the browser to actually post comments; no Reddit API key is used.
What are the current limits?Out of the box it only works with Reddit — Twitter, LinkedIn and Discord are listed as 'coming soon' and require manually copying the skill folder and writing new personalization files for each platform.
Who is this built for?It is aimed at indie founders and marketers who want to promote a product on Reddit through genuine-sounding engagement instead of obvious bot spam, including an optional lead-tracking file for interested users.
What is the 16-point quality checklist for?Before posting, the skill runs each drafted comment through 16 checks to make sure it reads naturally and doesn't look like an automated bot comment.
How does lead identification work?While scanning posts, the skill flags users who look like a good fit for your product and logs them to a leads file for follow-up.
What happens in batch mode?Batch mode automatically fills your daily quota, for example 24 comments across 8 subreddits, spacing posts 5-15 minutes apart so the activity looks human.
Why does the project warn against automating everything?The README's Responsible Use section asks users to mix in manual comments, avoid spam or false claims, and follow each community's rules rather than fully automating engagement.
What are similar projects?linkedin-agent-skill, postiz-agent, newsjack, skills, claude-skills, marketing-agi, linkedin-skills, marketingskills
Which topics is it in?reddit, automation-tools, cursor-ai, openclaw-skills, claude-ai, marketing-automation, social-media, claude-skill, marketing, playwright, content-creation, openclaw
Creator
rokpiy
Size
1.5 MB
Stars
585
Updated
CommitMar 15
Age
8mo
Commits · 90 Days