reddit-marketing-agent — Claude Code skill: find Reddit threads
A skill that searches Reddit for threads matching your keywords and drafts replies for them. Useful if you run a community or promote a product there.
npx skills add reason-machines/marketing-skills --skill reddit-marketing-agent -a claude-codeWhat reddit-marketing-agent does
The skill documents a Reddit workflow: search chosen subreddits, filter threads by keywords, and prepare replies that read like a person, not an ad. Inside are Python examples using praw for the Reddit API and OpenAI calls for text generation. A full-cycle script ties it together: search, filter by score and post age, generate replies for the top threads, save everything to a timestamped JSON file.
Settings live in config.yaml or config.json: subreddit list, keywords, filters (min_upvotes, max_age_hours, exclude_patterns) and reply options such as tone, max length and value-first ordering. To run it you need REDDIT_CLIENT_ID, REDDIT_CLIENT_SECRET, REDDIT_USER_AGENT and OPENAI_API_KEY in .env. No Reddit and OpenAI keys means the scripts stop at the first call, so register a Reddit app and set up model access first.
The point is a repeatable loop: strategy, logs and source context sit next to each other so you can revisit and adjust. The author advises a helpful tone and value before any mention. It is not an autoposter — the generator hands you a draft, you publish it yourself.
What it helps with
- find fresh threads in subreddits by keyword
- drop low-score and stale discussions
- write a reply that fits the thread without sounding promotional
- log found opportunities to JSON
- rerun the same search on a schedule
Example prompts for the agent
- find threads in r/Entrepreneur about marketing automation from the past week
- draft a reply to this thread in a helpful tone
- run the workflow from config.json and save the results
How to install reddit-marketing-agent
1Skills CLI (Vercel)
npx skills add reason-machines/marketing-skills --skill reddit-marketing-agent -a claude-code2Manually: put the files in place
~/.claude/skills/reddit-marketing-agent/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/reddit-marketing-agent/
1Skills CLI (Vercel)
npx skills add reason-machines/marketing-skills --skill reddit-marketing-agent -a codex2Manually: put the files in place
.agents/skills/reddit-marketing-agent/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add reason-machines/marketing-skills --skill reddit-marketing-agent -a cursor2Manually: put the files in place
.cursor/skills/reddit-marketing-agent/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install reason-machines/marketing-skills reddit-marketing-agent2Manually: put the files in place
.github/skills/reddit-marketing-agent/SKILL.md1Skills CLI (Vercel)
npx skills add reason-machines/marketing-skills --skill reddit-marketing-agent -a gemini-cli2Platform CLI
gemini skills install https://github.com/reason-machines/marketing-skills --path skills/reddit-marketing-agentManually: put the files in place
.devin/skills/reddit-marketing-agent/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add reason-machines/marketing-skills --skill reddit-marketing-agent -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about reddit-marketing-agent
How do I install reddit-marketing-agent in Claude?
Run npx skills add reason-machines/marketing-skills --skill reddit-marketing-agent -a claude-code. The skill lands in ~/.claude/skills/reddit-marketing-agent/SKILL.md.
What does reddit-marketing-agent do?
It searches Reddit threads in the subreddits and keywords you set, filters them by score and age, and drafts contextual replies. Results go to a JSON file.
What do I need to run it?
The Python packages praw, openai and python-dotenv, plus Reddit API and Anthropic keys in .env. Without them the search and generation scripts will not run.
