reddit-engagement — Claude Code skill: promoting on Reddit

---
name: reddit-engagement
description: When the user wants to promote on Reddit, engage developer subreddits, or understand Reddit self-promotion rules. Trigger phrases include "Reddit," "subreddit," "r/programming," "r/webdev," "self-promotion," "Reddit marketing," or "getting upvotes on Reddit."
metadata:
  version: 1.0.0
---

# Reddit Engagement

Reddit can drive massive developer traffic — or get you banned for self-promotion. This skill covers authentic engagement across developer subreddits, understanding each community's rules, and the comment-first strategy that actually works.

---

## Before You Start

1. Read `.agents/developer-audience-context.md` if it exists
2. Identify which subreddits your developers actually use
3. Create a dedicated Reddit account (using your real identity is fine, but don't use your company name as username)
4. Understand: Reddit requires months of genuine participation before self-promotion

---

## Developer Subreddit Landscape

### High-Traffic Developer Subreddits

| Subreddit | Members | Culture | Self-promo tolerance |
|-----------|---------|---------|---------------------|
| r/programming | 6M+ | Technical depth, skeptical | Very low |
| r/webdev | 2M+ | Practical, career-focused | Low |
| r/javascript | 2M+ | Framework debates, news | Low |
| r/Python | 1.5M+ | Helpful, educational | Moderate |
| r/devops | 500K+ | War stories, tools | Moderate |
| r/selfhosted | 400K+ | DIY, open source love | Moderate for OSS |
| r/sysadmin | 800K+ | Cynical, enterprise-focused | Very low |
| r/learnprogramming | 4M+ | Beginners, supportive | Low |
| r/ExperiencedDevs | 200K+ | Senior discussions, no beginners | Very low |
| r/cscareerquestions | 1M+ | Career advice, compensation | None |

### Niche Technical Subreddits

| Category | Subreddits | Notes |
|----------|------------|-------|
| Languages | r/rust, r/golang, r/typescript, r/cpp, r/java | Often more welcoming to relevant tools |
| Frameworks | r/reactjs, r/vuejs, r/angular, r/nextjs, r/django | Very specific content requirements |
| Infrastructure | r/kubernetes, r/docker, r/aws, r/terraform | Practical problems welcome |
| Specialties | r/netsec, r/machinelearning, r/datascience | Deep expertise expected |

---

## Understanding Subreddit Rules

### Check Before Posting

Every subreddit has different rules. Before engaging:

1. **Read the sidebar** — Rules, posting guidelines, allowed content
2. **Check the wiki** — Many have self-promotion policies
3. **Look at top posts** — What format/content succeeds
4. **Search for your competitors** — How did their posts do?
5. **Check moderator activity** — How strict is enforcement?

### Common Rule Patterns

| Rule type | What it means |
|-----------|---------------|
| "No self-promotion" | Your own stuff is banned entirely |
| "10:1 rule" | 10 helpful comments/posts for every self-promo |
| "No affiliate links" | Even indirect monetization banned |
| "Project showcase Sunday" | Self-promo limited to specific threads |
| "No beginners" | r/ExperiencedDevs, r/cscareerquestionsEU |
| "Text posts only" | No link posts, must add context |

### Self-Promotion Limits by Subreddit

| Tolerance | Subreddits | Strategy |
|-----------|------------|----------|
| **Zero** | r/programming, r/sysadmin, r/cscareerquestions | Don't post your stuff. Comment only. |
| **Showcase threads only** | r/webdev (Showoff Saturday) | Wait for weekly threads |
| **10:1 rule** | Most technical subreddits | Heavy comment investment first |
| **Open source friendly** | r/selfhosted, r/opensource, r/commandline | OSS gets more leeway |
| **More welcoming** | Niche language subs, small communities | Still need participation first |

---

## The Comment-First Strategy

### Why Comments Beat Posts

| Comments | Posts |
|----------|-------|
| Build karma and history | Require karma to post in many subs |
| Establish expertise | Subject to self-promo scrutiny |
| No self-promo restrictions | Often removed if promotional |
| Reach engaged audiences | Compete with all other posts |
| Can mention your work naturally | Direct promo usually fails |

### High-Value Comment Opportunities

| Opportunity | How to find | What to comment |
|-------------|-------------|-----------------|
| Questions in your area | Search by flair or keywords | Detailed, helpful answers |
| Discussions of problems you solve | Monitor relevant keywords | Share approach without pitching |
| Competitor mentions | Search competitor names | Fair comparison, not attack |
| "What tools do you use?" threads | Common in most dev subs | Honest mention among other tools |
| Frustrated users | Posts about problems | Empathize, help, maybe mention if very relevant |

### Comment Templates

**Answering a technical question**:
```
Good question. Here's what's worked for me:

[Specific technical answer with code/steps]

One thing to watch out for: [edge case or caveat]

I've been using [approach/tool] for this, and [specific benefit].
```

**When your tool is directly relevant** (use sparingly):
```
I work on [tool] and we built it specifically for this use case.

The way we handle [problem] is:
[Technical explanation]

Happy to answer questions if you want to try it. [No link unless asked]
```

**Sharing your experience** (no self-promo):
```
We ran into this exact issue at [scale/context].

What worked for us:
1. [Step one]
2. [Step two]
3. [Step three]

The key insight was [specific learning].
```

---

## What Gets Downvoted

### Content That Fails

| Type | Why it fails |
|------|--------------|
| Obvious self-promotion | Reddit hates marketers |
| Link-only posts | No context, feels spammy |
| Beginner content in advanced subs | Wrong audience |
| Rehashed content | "5 tips for..." articles |
| Clickbait titles | Community downvotes on principle |
| Corporate announcements | Not interesting to community |
| Poorly formatted posts | Walls of text, no structure |

### Behaviors That Get You Banned

| Behavior | Consequence |
|----------|-------------|
| Posting only your own links | Shadowban site-wide |
| Vote manipulation | Permanent ban, IP flagged |
| Multiple accounts for upvoting | All accounts banned |
| Spamming across subreddits | Banned from multiple subs |
| Arguing with moderators | Permanent ban |
| Circumventing bans | IP ban |

### Signs You're Doing It Wrong

- Posts consistently at 0 upvotes
- Comments getting buried
- Removed posts (check your profile in incognito)
- No engagement on your contributions
- Moderator warnings

---

## Building Reputation

### The Investment Required

| Timeframe | What to do |
|-----------|------------|
| **Month 1** | Comment only. No posts. Build karma. Learn culture. |
| **Month 2** | More comments. Maybe post helpful content (not yours). |
| **Month 3** | Continue commenting. Occasional showcase thread participation. |
| **Month 4+** | Earned enough goodwill to occasionally share your work. |

### Karma-Building Strategy

| Action | Karma potential | Notes |
|--------|----------------|-------|
| Answer questions in /new | Medium | Less competition, help beginners |
| Add context to trending posts | High | Ride momentum |
| Share interesting links (not yours) | Medium | Curate good content |
| Post in showcase threads | Low | But builds history |
| Deep technical explanations | High | Demonstrates expertise |

### Profile Optimization

Your Reddit profile tells your story:

- **Username**: Professional but not corporate
- **Comment history**: Should show genuine participation
- **Karma ratio**: Comments should far exceed posts
- **Subreddit diversity**: Active in multiple relevant communities
- **Account age**: Older accounts get more trust

---

## Platform-Specific Do's and Don'ts

### Do's

1. **Do** read subreddit rules before every post
2. **Do** contribute to discussions genuinely
3. **Do** answer questions in your area of expertise
4. **Do** wait weeks/months before any self-promotion
5. **Do** use weekly showcase threads when available
6. **Do** disclose your affiliation when mentioning your work
7. **Do** accept criticism gracefully
8. **Do** format posts well (headers, bullets, code blocks)

### Don'ts

1. **Don't** post your own links more than 10% of activity
2. **Don't** ask for upvotes (ever, anywhere)
3. **Don't** use multiple accounts
4. **Don't** post the same thing to multiple subreddits
5. **Don't** argue with moderators
6. **Don't** ignore subreddit-specific rules
7. **Don't** pitch in others' threads
8. **Don't** delete and repost (looks spammy)

---

## Crossposting Strategy

### When to Crosspost

| Crosspost when | Don't crosspost when |
|----------------|---------------------|
| Content genuinely fits multiple communities | Just trying to get more views |
| Each sub has different audience | Same core audience |
| You tailor the title/context | Copy-paste across subs |
| Posts are spaced out | Posting everywhere at once |

### Crosspost Best Practices

1. **Customize the title** for each subreddit's culture
2. **Add a comment** explaining why it's relevant to that sub
3. **Space out posts** by hours or days
4. **Prioritize** — post to most relevant sub first
5. **Don't crosspost** to more than 2-3 subreddits

---

## Reddit Advertising Alternative

If organic doesn't work, Reddit Ads exist:

| Ad type | Use case | Notes |
|---------|----------|-------|
| Promoted posts | Brand awareness | Can target by subreddit |
| Conversation placements | In-feed native | Looks like regular posts |

**When to use ads instead of organic**:
- You need immediate reach
- Organic would violate self-promo rules
- You're promoting an event with a deadline
- You've been warned about self-promotion

---

## Tools

| Tool | Use case |
|------|----------|
| **[Octolens](https://octolens.com)** | Monitor Reddit for mentions of your product, competitors, and problem-space keywords. Get alerts for threads where your expertise is relevant. |
| **Reddit Search (old.reddit.com)** | Better search than new Reddit |
| **Keyword alerts** | Track when topics come up |
| **Removeddit/Reveddit** | See if your posts are being removed |

---

## Subreddit Launch Checklist

Before posting your project:

- [ ] 30+ days of genuine commenting in that subreddit
- [ ] Read and understood subreddit rules
- [ ] Checked if showcase threads exist
- [ ] Have other non-promotional posts in history
- [ ] Post formatted properly (not just a link)
- [ ] Title follows subreddit conventions
- [ ] Ready to engage with comments for hours
- [ ] Prepared for criticism

---

## Related Skills

- `developer-audience-context` — Know which subreddits your devs use
- `hacker-news-strategy` — Similar dynamics, different platform
- `dev-to-hashnode` — Create content to link from Reddit
- `github-presence` — What Redditors check when evaluating your project