Reddit Curator

# SKILL.md - Reddit Curator

## Description
Your personal Reddit editor. Curates, summarizes, and delivers a daily digest of the best content from your favorite subreddits — no doom-scrolling, no noise, just signal.

## Price
**Free** — or **$3** to support development.

## Prerequisites
- Reddit API credentials (free via reddit.com/prefs/apps)
- Telegram or email for delivery
- Optional: OpenAI/Anthropic API for enhanced summaries

## Quick Start
1. **Get Reddit API access:**
   - Go to reddit.com/prefs/apps
   - Create "script" app
   - Note: client_id, client_secret, username, password
2. **Configure:** "Set up my Reddit curator"
3. **Add subreddits:** "Add r/AskReddit, r/technology, r/personalfinance"
4. **Set schedule:** "Deliver my digest every morning at 8am"

## Commands
- "Add r/[subreddit]" — Add to your curated list
- "Remove r/[subreddit]" — Remove from list
- "Show my subreddits" — List configured communities
- "Set digest time to [time]" — Schedule daily delivery
- "Set min upvotes to [number]" — Filter threshold
- "Add keyword filter: [word]" — Only posts containing keyword
- "Show me today's digest" — Manual delivery
- "Pause digest" — Temporarily stop
- "Resume digest" — Restart delivery

---

## Core Workflows

### 1. Daily Digest Generation

**Trigger:** Scheduled time (default: 8am) or manual request

**Process:**
1. Scan each configured subreddit (top + hot posts, last 24h)
2. Filter by:
   - Minimum upvote threshold (default: 100)
   - Keyword filters (if configured)
   - Flair filters (if configured)
   - Already-seen posts (deduplication)
3. Score each post:
   - Engagement score: (upvotes + comments × 2) / age_hours
   - Quality score: length, awards, crossposts
   - Relevance score: keyword matches, user preferences
4. Select top 5-10 posts across all subreddits
5. Generate summaries:
   - Title + author + subreddit
   - Key points from post text
   - Top 3 comments summary
   - Link to full post
6. Format digest with sections by subreddit
7. Deliver via configured channel

**Output Format:**
```markdown
🗞️ Your Reddit Digest — March 4, 2025

## r/AskReddit
**1. "What's a life hack everyone should know?"** ⭐ 12.4k upvotes
- *Key insight:* The "two-minute rule" — if something takes <2 min, do it now
- *Top comment:* Batch similar tasks to reduce context switching
- [Read full thread](link)

## r/technology
**2. "OpenAI announces GPT-5"** ⭐ 8.7k upvotes
- *Summary:* New model shows 40% improvement on reasoning tasks
- *Key detail:* API pricing unchanged, rollout starts next week
- [Read full thread](link)

## r/personalfinance
**3. "I paid off $50k debt in 2 years"** ⭐ 5.2k upvotes
- *Strategy:* Avalanche method + side income + expense tracking
- *Top tip:* Automate all payments, treat savings as expense
- [Read full thread](link)

---
*Curated from 8 subreddits | 47 posts scanned | 12 matched your filters*
*Reply "pause" to stop | "add r/[name]" to expand | "settings" to customize*
```

### 2. Smart Filtering

**Upvote Thresholds:**
- **Casual:** 50+ upvotes (more content, some noise)
- **Curated:** 100+ upvotes (balanced, default)
- **Premium:** 500+ upvotes (only hits, less frequent)

**Keyword Filters:**
- Include: Only posts containing these words
- Exclude: Filter out posts with these words
- Example: Include "tutorial guide how-to", exclude "meme shitpost"

**Flair Filters:**
- Only show posts with specific flairs
- Example: "Discussion", "Serious", "Advice"

**Time Windows:**
- Last 24 hours (default)
- Last 7 days (weekly digest option)
- Last hour (breaking news mode)

### 3. Content Scoring Algorithm

```
Post Score = (Base Score + Engagement Bonus) × Quality Multiplier × Recency Decay

Base Score = upvotes × 1 + comments × 2
Engagement Bonus = awards × 50 + crossposts × 25
Quality Multiplier = 1.0 to 1.5 (based on post length, formatting)
Recency Decay = 1.0 (0-6h) → 0.8 (6-12h) → 0.6 (12-24h)
```

### 4. Summary Generation

**For text posts:**
- Extract 3-5 key points
- Identify main question/claim
- Summarize top comments (diverse viewpoints)

**For link posts:**
- Fetch article title + description
- Extract key quote if available
- Note: "External link — summary based on title/comments"

**For media posts:**
- Describe content type (image, video, gif)
- Summarize top comments explaining context
- Note: "Media post — see link for full content"

### 5. Delivery Options

**Telegram:**
- Formatted markdown
- Inline buttons: "Read more", "Next post", "Save for later"
- Image previews (if media post)

**Email:**
- HTML formatted digest
- Clickable links
- Mobile-responsive

**Discord:**
- Embed format
- Channel-specific delivery
- Thread creation for discussion

---

## Configuration

### curator-config.json
```json
{
  "reddit": {
    "client_id": "YOUR_CLIENT_ID",
    "client_secret": "YOUR_SECRET",
    "username": "YOUR_REDDIT_USERNAME",
    "password": "YOUR_REDDIT_PASSWORD",
    "user_agent": "RedditCurator/1.0 by YOUR_USERNAME"
  },
  "delivery": {
    "method": "telegram",
    "chat_id": "YOUR_CHAT_ID",
    "time": "08:00",
    "timezone": "America/Denver"
  },
  "filters": {
    "min_upvotes": 100,
    "max_posts_per_subreddit": 3,
    "max_total_posts": 10,
    "time_window_hours": 24,
    "include_keywords": [],
    "exclude_keywords": ["meme", "shitpost"],
    "include_flairs": [],
    "exclude_flairs": ["Meme"]
  },
  "subreddits": [
    {
      "name": "AskReddit",
      "weight": 1.0,
      "min_upvotes": 200
    },
    {
      "name": "technology",
      "weight": 1.2,
      "min_upvotes": 100
    }
  ],
  "summarization": {
    "enabled": true,
    "model": "claude-sonnet",
    "max_length": 150
  }
}
```

---

## Advanced Features

### Trend Detection
- Track which subreddits are trending up/down
- Alert on unusual activity spikes
- "r/technology is 3x more active than usual today"

### Saved Posts Sync
- Auto-save digested posts to Reddit "Saved"
- Create curated lists by topic
- Export saved posts to Notion/Obsidian

### Cross-Subreddit Analysis
- "This topic is trending across 3 of your subreddits"
- Detect emerging themes
- Surface cross-community discussions

### Weekly Roundup
- Best of the week (highest scored posts)
- Trending topics summary
- New subreddit recommendations based on interests

### Breaking News Mode
- Monitor for high-velocity posts (rising fast)
- Immediate alert for major events
- Override schedule for urgent content

---

## Examples

### Example 1: Tech Professional Setup
```
User: "Add r/programming, r/webdev, r/MachineLearning, r/technology"
User: "Set min upvotes to 200"
User: "Add keyword filter: tutorial, guide, open source"
User: "Deliver at 7am"

Result: Daily digest of high-quality tech content, 
focusing on educational posts and open source projects.
```

### Example 2: Casual Browsing
```
User: "Add r/AskReddit, r/LifeProTips, r/todayilearned"
User: "Set min upvotes to 500"
User: "Exclude keywords: politics, NSFW"

Result: Entertaining, broadly-appealing content only,
no controversial or explicit material.
```

### Example 3: Finance Focus
```
User: "Add r/personalfinance, r/investing, r/financialindependence"
User: "Add keyword filter: strategy, advice, experience"
User: "Set digest time to 6pm"

Result: Evening digest of financial wisdom and 
investment discussions to review after work.
```

---

## Guardrails

**Respect Reddit:**
- Rate limit: 1 request per second
- Cache results to minimize API calls
- Follow Reddit API terms of service
- Don't republish content commercially

**User Privacy:**
- Credentials stored encrypted
- No tracking of user reading habits
- No sharing of curated lists

**Content Warnings:**
- Flag potentially controversial content
- Respect NSFW filters
- Allow keyword-based content blocking

---

## Troubleshooting

**Error: "Reddit API rate limited"**
- Wait 10 minutes, retry
- Reduce number of subreddits
- Increase time between scans

**Error: "No posts found"**
- Lower upvote threshold
- Add more subreddits
- Check keyword filters aren't too restrictive

**Error: "Authentication failed"**
- Verify Reddit credentials
- Check 2FA isn't blocking API access
- Regenerate API keys if needed

**Digest not delivering**
- Check delivery method configuration
- Verify Telegram chat ID or email
- Check scheduled time and timezone

---

## Version History
- **V1.0:** Daily digest, basic filtering, Telegram delivery
- **V1.1:** Smart scoring, keyword filters, flair filtering
- **V1.2:** Multi-channel delivery (email, Discord), weekly roundup
- **V1.3:** Trend detection, cross-subreddit analysis, saved posts sync

---

*Curate your internet. Save your time.*