🎁 Get the FREE AI Skills Starter GuideSubscribe →
BytesAgainBytesAgain
🦀 ClawHub

Reddit Curator

by @geoffguides

Curates and summarizes top posts daily from your chosen subreddits, filtering by upvotes and keywords, and delivers a clean Reddit digest to email or Telegram.

Versionv1.0.0
Downloads306
TERMINAL
clawhub install reddit-curator

📖 About This Skill

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:

    🗞️ 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
  • 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
  • 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

  • *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

    {
      "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.*

    💡 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.


    ⚙️ Configuration

    curator-config.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
      }
    }
    


    📋 Tips & Best Practices

    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