agentleFS
fortunto2fortunto2/solo-factory/skills/reddit/SKILL.md

solo-reddit

Skill18 starsChanged 4 months agoMITView on GitHub

Use when "reddit comment", "engage reddit", "build karma", "post to reddit", or need to participate in Reddit threads. NOT for thread discovery (/community-outreach) or social copy (/content-gen).

The file

Show its rules and text

We split this skill into the rules it gives an agent

21 rules. About 0 are common, 13 are distinctive, and 8 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈13

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 8

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    If MCP tools not available, use WebSearch/WebFetch as fallback.

    line 50
  2. Distinctive:

    Use scripts first (faster, no Playwright needed).

    line 57
  3. Distinctive:

    Read sidebar rules (via WebFetch or Playwright)

    line 70
  4. Distinctive:

    NOT already commented on (check tracking)

    line 127
  5. Distinctive:

    Write and optionally post a comment on a specific Reddit post.

    line 137
  6. Very specific:

    Read docs/reddit/profile.md for voice guide

    line 140
  7. Very specific:

    Read docs/reddit/tracking.md to check we haven't commented on this post

    line 141
  8. Very specific:

    Read references/style-guide.md for comment patterns

    line 142
  9. Distinctive:

    Write a comment following these rules:

    line 152
  10. Very specific:

    Check the draft against references/spam-signals.md:

    line 161
  11. Distinctive:

    If any check fails: rewrite.

    line 170
  12. Very specific:

    If Playwright not available: copy comment to clipboard via pbcopy.

    line 180
  13. Distinctive:

    Create a Reddit post for a specific subreddit.

    line 194
  14. Distinctive:

    Do we have 10+ tracked comments in this subreddit?

    line 197
  15. Distinctive:

    Check subreddit rules for post format, flairs, allowed content types.

    line 198
  16. Distinctive:

    Check if showcase/self-promo threads exist (e.g., "Showoff Saturday").

    line 199
  17. Very specific:

    Run scripts/check-karma.sh to verify account status.

    line 233
  18. Very specific:

    Run scripts/search-posts.sh for target subreddit.

    line 234
  19. Distinctive:

    Wait 5-10 minutes between comments (rate limiting).

    line 236
  20. Very specific:

    Write structured summary to docs/reddit/batch-{date}.json:

    line 237
  21. Distinctive:

    Always disclose affiliation: when mentioning your product

    line 269

≈ “Common” is an estimate: at least 1 in 5 of the 372,429 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

/reddit

Reddit engagement automation — from finding relevant posts to writing authentic comments and tracking results. Comment-first strategy: build karma and reputation before any self-promotion.

Philosophy

  • Value first, product never (in comments) — genuinely help, mention product only when directly asked
  • Comment-first — 30+ comments before any self-promotional post
  • Read before write — analyze post, existing comments, subreddit culture before drafting
  • Track everything — karma growth, engagement rates, what works

Routing

User saysAction
/reddit setup <project>Go to Setup section
/reddit find [subreddit]Go to Find Posts section
/reddit comment [url]Go to Comment section
/reddit post <subreddit>Go to Write Post section
/reddit statusGo to Status section
/reddit batch [subreddit]Go to Batch Mode — find + comment x3

MCP Tools

Playwright (required for posting)

  • browser_navigate(url) — go to Reddit page
  • browser_snapshot() — read page structure (accessibility tree, NOT screenshots)
  • browser_click(ref) — click elements
  • browser_type(ref, text) — type text
  • browser_wait_for(state) — wait for page load

SoloGraph (optional, for search)

  • web_search(query) — search Reddit threads
  • kb_search(query) — find project context
  • project_info(name) — get project details

If MCP tools not available, use WebSearch/WebFetch as fallback.

Scripts (no MCP needed)

  • scripts/check-karma.sh <username> — check karma, account age, posting readiness
  • scripts/search-posts.sh <subreddit> [query] [sort] — find posts via Reddit JSON API
  • scripts/check-post.sh <url> — read post content + top comments

Use scripts first (faster, no Playwright needed). Fall back to Playwright for posting.

Setup

First-time setup for a project. Creates profile and tracking files.

  1. Parse project from $ARGUMENTS or ask user.
  2. Read PRD/README to extract: problem, solution, ICP, key features, competitor names.
  3. Identify target subreddits — search for where ICP hangs out:
    • Language/framework subs (r/rust, r/python, r/javascript)
    • Domain subs (r/selfhosted, r/devops, r/ClaudeAI)
    • General tech (r/programming, r/webdev)
  4. Research each subreddit:
    • Read sidebar rules (via WebFetch or Playwright)
    • Check self-promotion policy
    • Note posting format, flairs, weekly threads
    • Find top posts to understand culture
  5. Write profile to docs/reddit/profile.md:
# Reddit Profile: {Project Name}

**Product:** {one-line}
**ICP:** {target persona}
**Value prop for Reddit:** {what genuine help can we offer}

## Target Subreddits

| Subreddit | Members | Self-promo | Culture | Best content type |
|-----------|---------|------------|---------|-------------------|
| r/xxx | NNNk | rules... | tone... | type... |

## Search Keywords
- Problem: {what users complain about}
- Solution: {what users search for}
- Competitors: {names for "vs" and "alternative" threads}

## Voice Guide
- Tone: {casual/technical/friendly}
- Never say: {banned phrases — "game-changer", "revolutionary", etc.}
- Always: {disclose affiliation, lead with value}
  1. Create tracking file docs/reddit/tracking.md:
# Reddit Tracking

## Stats
- Account: {username}
- Starting karma: {N}
- Comments posted: 0
- Posts made: 0

## Activity Log
<!-- entries added by /reddit comment and /reddit post -->

Find Posts

Find posts worth commenting on in a subreddit.

  1. Load profile from docs/reddit/profile.md.
  2. Search for relevant threads:
    • Via WebSearch: "{keyword}" site:reddit.com/r/{subreddit} for each keyword group
    • Or via Playwright: navigate to reddit.com/r/{subreddit}/new/ and reddit.com/r/{subreddit}/rising/
  3. Filter posts:
    • Less than 7 days old (prefer < 24h for visibility)
    • 2-30 comments (active but not buried)
    • Matches problem/solution/competitor keywords
    • NOT already commented on (check tracking)
  4. Score and rank top 5 posts by:
    • Relevance to our expertise (high)
    • Comment count sweet spot (medium = best)
    • Recency (newer = better)
    • Can we genuinely help? (must be yes)
  5. Output ranked list with URLs, titles, why each is good.

Comment

Write and optionally post a comment on a specific Reddit post.

Step 1: Load Context

  • Read docs/reddit/profile.md for voice guide
  • Read docs/reddit/tracking.md to check we haven't commented on this post
  • Read references/style-guide.md for comment patterns

Step 2: Deep Analysis

Navigate to the post URL (via Playwright or WebFetch):

  • Read the full post — understand what OP actually asks
  • Read existing comments — understand tone, what's been said, gaps
  • Identify OP's intent: asking for help? sharing experience? seeking opinions?
  • Decide angle: what unique value can we add that others haven't?

Step 3: Draft Comment

Write a comment following these rules:

  • Match subreddit tone — casual for r/ClaudeAI, technical for r/rust
  • Lead with value — first 2-3 sentences directly address OP's question
  • Be specific — code snippets, numbers, concrete steps > vague advice
  • 1-2 focused points — don't try to cover everything
  • No product mention unless directly relevant AND we have 10+ comments in this sub
  • If mentioning product: last paragraph, with "I work on X" disclosure

Step 4: Anti-Spam Review

Check the draft against references/spam-signals.md:

  • No marketing language ("game-changer", "revolutionary", "10x")
  • No link in first comment on a subreddit
  • Not a copy of any previous comment
  • Directly addresses OP's question (not tangential)
  • Would be useful even if product didn't exist
  • Reads like a human, not a press release
  • No emoji overuse (0-1 max)

If any check fails: rewrite.

Step 5: Post (if Playwright available and user approves)

  1. browser_navigate(post_url)
  2. browser_snapshot() — find comment input
  3. browser_click(comment_box_ref)
  4. browser_type(comment_box_ref, comment_text)
  5. browser_click(submit_button_ref)
  6. browser_snapshot() — verify posted, get permalink

If Playwright not available: copy comment to clipboard via pbcopy.

Step 6: Track

Update docs/reddit/tracking.md:

### {YYYY-MM-DD HH:MM} r/{subreddit}
- **Post:** [{title}]({url})
- **Comment:** [{permalink}]({comment_url})
- **Angle:** {what value we provided}
- **Product mentioned:** yes/no

Write Post

Create a Reddit post for a specific subreddit.

  1. Pre-flight checks:
    • Do we have 10+ tracked comments in this subreddit? If no: STOP, comment more first.
    • Check subreddit rules for post format, flairs, allowed content types.
    • Check if showcase/self-promo threads exist (e.g., "Showoff Saturday").
  2. Determine post type:
    TypeWhen to use
    Experience sharingWe solved a hard problem — share the story
    Technical deep-diveInteresting approach worth discussing
    Tool announcementOnly in subs that allow it, with heavy context
    Question/discussionGenuine question that sparks conversation
  3. Draft post:
    • Title: specific, accurate, matches sub format (check top posts)
    • Body: value-first structure from references/post-templates.md
    • Links: max 1-2, put extras in first comment
    • Flair: match subreddit requirements
  4. Review against rules:
    • 90/10 rule: 90% value, 10% promotional
    • No clickbait titles
    • Follows subreddit-specific format
    • Would you upvote this if it wasn't yours?
  5. Post via Playwright or copy to clipboard.
  6. After posting:
    • Monitor comments for 2 hours
    • Reply to every comment (boosts ranking)
    • Track in docs/reddit/tracking.md

Batch Mode

Efficient mode: find 3 posts + write 3 comments in one session.

  1. Load profile and tracking.
  2. Run scripts/check-karma.sh to verify account status.
  3. Run scripts/search-posts.sh for target subreddit.
  4. For top 3 candidates, run Comment flow sequentially.
  5. Wait 5-10 minutes between comments (rate limiting).
  6. Write structured summary to docs/reddit/batch-{date}.json:
{
  "date": "2026-03-25",
  "subreddit": "r/ClaudeAI",
  "comments_posted": 3,
  "posts": [
    {"url": "...", "title": "...", "angle": "...", "product_mentioned": false}
  ],
  "karma_before": 37,
  "karma_after": null
}
  1. Print human summary: 3 comments posted, links, karma status.

Status

Show current Reddit engagement stats.

  1. Read docs/reddit/tracking.md.
  2. Count: total comments, comments per subreddit, posts made.
  3. Calculate: comments since last promotional post (10:1 ratio check).
  4. Show readiness: "Ready to post in r/X" or "Need N more comments in r/X".

Critical Rules

  1. Never post without reading the full thread — context is everything
  2. Never mention product in first 10 comments in any subreddit
  3. Never post same content to multiple subreddits — customize each
  4. Never argue with moderators — accept removal gracefully
  5. Always disclose affiliation when mentioning your product
  6. Minimum 5 minute gap between comments (avoid rate limiting)
  7. No vote manipulation — never ask for upvotes anywhere
  8. Use browser_snapshot not browser_take_screenshot — saves tokens
  9. Navigate by URL (browser_navigate) not clicking links — prevents errors

Gotchas

  1. Reddit spam filter on low-karma accounts — new or inactive accounts get auto-filtered. Build 50+ karma with genuine comments before any self-promo posts. If filtered: message mods via modmail (sidebar link), don't repost.
  2. Links trigger spam filter — first comment with a link in a new subreddit often gets caught. Post text-only comments first, add links only after established.
  3. Subreddit AI content rules — r/rust and others may remove posts with AI-generated content. Be transparent about AI-assisted development but ensure comments are genuinely human-directed.
  4. Rate limiting — Reddit throttles new/low-karma accounts. If you see "you're doing that too much", wait 10 minutes. Don't retry immediately.
  5. Old Reddit vs New Reddit — old.reddit.com has better search. Use new.reddit.com for posting (Playwright works better with new UI).
  6. Playwright login state — Reddit login persists in browser session. If logged out: user must log in manually (browser_navigate("https://www.reddit.com/login")), skill can't enter credentials.

Notes

  • This skill complements /community-outreach (which finds threads) and /content-gen (which generates post copy). Use /reddit for the actual engagement loop.
  • For Reddit Ads, see the reddit-ads skill from kostja94/marketing-skills.
  • Karma builds compound: each good comment makes the next one more visible.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.