reddit-icp-monitor

​

Install

npx "@opendirectory.dev/skills" install reddit-icp-monitor --target claude

npx skills add Varnan-Tech/opendirectory --skill reddit-icp-monitor

/plugin marketplace add Varnan-Tech/opendirectory
/plugin install opendirectory-gtm-skills@opendirectory-marketplace

​

What It Does

• Reads your ICP definition from docs/icp.md (or asks 3 questions to build it)
• Searches specified subreddits for posts matching your pain point phrases
• Scores each candidate post 1-5 using Gemini (how clearly does this person have the problem you solve?)
• Drafts a helpful reply for every post scoring 4 or 5, in the correct mode (vent, how-do-you, or tool recommendation)
• Enforces a hard rule: replies never name your product unless the post explicitly asks for tool recommendations
• Saves the full report to docs/reddit-intel/YYYY-MM-DD.md

​

Requirements

​

Setup

cp .env.example .env

• GEMINI_API_KEY (required)
• Reddit credentials (optional, see OAuth Upgrade below)

​

How to Use

"Monitor Reddit for my ICP signals"
"Scan subreddits for people who need my product"

"Check Reddit for buying signals"
"Run the Reddit ICP monitor for this week"
"Find ICP posts from the last month"

"Monitor Reddit for ICP signals from the last 24 hours"
"Check Reddit for this month's pain point posts"

​

Output

• All subreddits monitored and time window
• Each high-signal post: title, URL, upvotes, signal quote, matched keyword, post type
• A drafted reply for each match (2-5 sentences, mode-appropriate)
• A list of subreddits that returned 0 results (for tuning)

​

Reply Modes

​

Choosing Good Subreddits

• r/devops, r/ExperiencedDevs, r/sysadmin: engineers asking operational questions
• r/startups, r/SaaS, r/EntrepreneurRideAlong: founders and operators venting about scaling
• r/sales, r/marketing: GTM practitioners asking how others handle things

• Topic subreddits (r/programming, r/MachineLearning): discussions, not pain points
• Your product’s own subreddit: not monitoring your own community
• Broad consumer subreddits: not your B2B ICP

​

OAuth Upgrade

1. Go to reddit.com/prefs/apps and create a “script” app
2. Note: app approval may take several days as of late 2025
3. Fill in REDDIT_CLIENT_ID, REDDIT_CLIENT_SECRET, REDDIT_USERNAME, REDDIT_PASSWORD in .env

​

Project Structure

reddit-icp-monitor/
├── SKILL.md
├── README.md
├── .env.example
├── evals/
│   └── evals.json
└── references/
    ├── icp-format.md
    └── reply-rules.md

​

License