reddit-ai-search
Skill0 starsChanged 19 days agoMITView on GitHub
When the user wants to use Reddit as a channel for AI search visibility: find which buyer prompts make ChatGPT, Perplexity and Gemini cite Reddit, measure the share of Reddit citations per subreddit and per engine, run a monthly tracking routine, and read the results without fooling themselves. Also use when the user mentions 'GEO,' 'AI search visibility,' 'does reddit help us show up in ChatGPT,' 'reddit citations,' 'share of citations,' 'which engine cites reddit,' 'track AI mentions,' or 'is reddit worth it for AI search.' Reads the buyer prompts from reddit-context. Uses subreddit-research for the subreddit list and ai-cited-threads to act on single threads. Reports to the user, not to a dashboard.
In this repository9 other files it gives its agents.
- ai-cited-threadsSkill
- reddit-account-healthSkill
- reddit-adsSkill
- reddit-commentsSkill
- reddit-contextSkill
- reddit-listeningSkill
- reddit-postsSkill
- subreddit-researchSkill
- subreddit-rulesSkill
The file
We split this skill into the rules it gives an agent
8 rules. About 0 are common, 5 are distinctive, and 3 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈5
Distinctive · estimate
This author's own choices. Worth a look.
3
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 17
Read .agents/reddit-marketing.md if it exists (the reddit-context skill writes it).
- Very specific: line 44
Pull the subreddit baseline: Run find_subreddits with the category, then get_subreddit on each result.
- Distinctive: line 47
Run the prompts: Run each prompt in ChatGPT (web search on), Perplexity and Gemini, in fresh sessions, twice on different days.
- Very specific: line 101
Run find_subreddits with your category.
- Distinctive: line 105
Run 10 of your buyer prompts in Perplexity.
- Distinctive: line 127
Every number in the report has a source and a date in the same sentence.
- Distinctive: line 132
Only one lever changed this month, and its prediction was written before the month started.
- Distinctive: line 156
reddit-ads: use when an ad, not a comment, is the right way to reach the same buyers.
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Reddit for AI Search
You treat Reddit as one channel inside AI search (also called GEO or AEO): which buyer questions pull Reddit into an AI answer, which subreddits and threads those answers link to, how that differs by engine, and whether the work the user does on Reddit moves the numbers. You measure first, change one thing at a time, and report what the data can and cannot say.
Before you start
Read .agents/reddit-marketing.md if it exists (the reddit-context skill writes it). Use its buyer prompts,
competitors, subreddits and disclosure line. If it is missing, ask for: the product in one line, the category in the
words a buyer uses, 3 competitors, and 10 questions a buyer would type into an AI assistant. Offer to run
reddit-context first.
The data this skill uses
The CommunityMentions MCP is public, no sign-in: https://communitymentions.com/api/mcp. It holds 34,493 AI
citations across 75,343 AI answers as of 2026-10-28 (CommunityMentions data). That is 0.46 citations per answer
across the whole dataset (34,493 / 75,343, derived 2026-10-28). It is a ratio of this dataset, not the share of AI
answers that cite Reddit in general.
find_subreddits("description of product or niche") returns up to 10 subreddits with AI citations, members and threads cited, plus the median citations of subreddits cited 50+ times (96 in the 2026-10-28 pull).get_subreddit("SaaS" or "r/SaaS") returns citations, answers citing, threads cited, citations by engine (OpenAI models, Perplexity, Gemini), citing answers by question type, the date range, rank, and the top 5 threads.
Field meanings are in references/engine-data.md. The dataset covers subreddits cited 50+ times or with 50+ verified
placed comments. A subreddit missing from it may still be cited. Write "not in the data", never zero.
Workflow
- Set the question. One line: "Which Reddit communities do AI answers cite for
<category>buyers, and are we in them?" Write the date range you will compare each month. - Build the prompt set. 20-30 buyer prompts across the three question types (comparing products, looking to
buy, describing a problem). Template and wording rules in
references/prompt-set.md. Freeze the wording. A changed prompt breaks the month-to-month comparison. - Pull the subreddit baseline. Run
find_subredditswith the category, thenget_subredditon each result. Copy citations, engine split, question-type split, top thread share and date range into the sheet (references/tracking-sheet.md). Quote each number withcited_to. - Run the prompts. Run each prompt in ChatGPT (web search on), Perplexity and Gemini, in fresh sessions, twice on different days. Record every source URL. Mark Reddit URLs, the subreddit, the thread, and whether your brand is named in the answer text or in the thread.
- Compute four numbers per engine (formulas in
references/tracking-sheet.md): Reddit presence rate (runs with 1+ Reddit source), Reddit source share (Reddit URLs over all source URLs), subreddit share (one subreddit's Reddit URLs over all Reddit URLs), and brand-in-answer rate (runs whose answer text names you). - Find the gaps. List the prompts where Reddit is cited and you are not named. Those prompts point to threads
for
ai-cited-threads. List the prompts where Reddit is not cited at all; Reddit work will not help there, so look at the other sources the engine used. - Choose one lever per month from
references/levers.md. Examples: reply on 5 threads with disclosure, fix a thin answer on your own site, ask real customers to share their experience in a thread you do not control. Write the lever, the date and the prediction in the sheet before you start. - Re-run next month with the same prompts, same engines and same method. Compare, following
references/reading-results.md. Report ranges, not points. - Report in the format below. Hand thread-level work to
ai-cited-threads, rule checks tosubreddit-rules.
A worked example: eight subreddits (CommunityMentions data, 2026-10-28)
Each row is one get_subreddit call on 2026-10-28. Counts are AI citations over each subreddit's date range
(earliest start 2026-02-20, latest end 2026-10-23).
| Subreddit | Citations | OpenAI models | Perplexity | Gemini | Top thread |
| r/SaaS | 300 | 40 | 208 | 52 | 25 |
| r/b2bmarketing | 234 | 22 | 150 | 62 | 24 |
| r/smallbusiness | 210 | 20 | 164 | 26 | 11 |
| r/Entrepreneur | 170 | 13 | 135 | 22 | 19 |
| r/ecommerce | 126 | 10 | 106 | 10 | 21 |
| r/sales | 124 | 11 | 103 | 10 | 10 |
| r/coldemail | 96 | 52 | 43 | 1 | 13 |
| r/marketing | 52 | 0 | 35 | 17 | 10 |
| Total | 1,312 | 168 | 944 | 200 |
What the numbers say, and no more:
- Perplexity made 944 of 1,312 citations, 72%. OpenAI models made 168 (13%) and Gemini 200 (15%). This is eight chosen subreddits, so it does not describe all of Reddit.
- Two subreddits break the pattern. OpenAI models made 52 of 96 citations in r/coldemail (54%) and 0 of 52 in r/marketing. The engine mix depends on the subreddit, so measure your subreddits.
- Looking to buy was the biggest question type: 710 of the 1,312 citations (54%), then describing a problem 336
(26%) and comparing products 266 (20%). The tool names this field
citing_answers_by_question_type; in all eight pulls its three parts add up to the subreddit's citation count. - Threads are cited more than once. r/b2bmarketing has 234 citations over 52 threads, 4.5 per thread; r/coldemail has 96 over 44, 2.2.
- The top thread's share of a subreddit's citations ranges from 5% (11 of 210 in r/smallbusiness) to 19% (10 of 52 in r/marketing).
What the numbers cannot say: whether a citation led to a click, a sale or a brand mention in the answer; whether these counts match what your buyers' prompts show; whether the engine mix will hold next month. Test each one.
Is Reddit worth it for your category?
Answer this before any monthly routine. Takes about 30 minutes.
- Run
find_subredditswith your category. Ifno_close_matchis true, or every match shows "under 50 AI citations", the dataset has little for you. Say so and run your prompts by hand before spending more. - Compare each match's
ai_citationswith themedian_ai_citationsthe tool returns (96 for "cold email software for B2B outbound", CommunityMentions data, 2026-10-28). Above the median is a stronger signal. - Run 10 of your buyer prompts in Perplexity. Count how many list a Reddit source. If none do, Reddit is a weak channel for your category on that engine. Repeat in ChatGPT and Gemini.
- Decide: go (several prompts cite Reddit), watch (a few do), or stop (none do). Write the date and the count.
There is no published cutoff for "several" or "a few". Set yours and write it down before you count.
How this differs from classic SEO tracking
- A Reddit thread can be cited while ranking nowhere in Google for the same wording. Track citations in the engine, not rank in a search results page.
- The unit is a thread, not a keyword. A handful of threads can carry a subreddit's citations (5 threads held 82 of r/SaaS's 300, CommunityMentions data, 2026-10-28).
- You cannot own the page. Your influence is a comment, a thread or the customers who post. Plan for removal.
- Time lag is unknown. Test it: log the day of each lever and re-run at 14, 30 and 60 days.
Report format
- Date, prompt count, engines, and the date range of each dataset number.
- A table: subreddit, citations, engine split, and your own Reddit presence rate for the prompts tied to it.
- Three findings, each with its number, source and date.
- The one lever for next month with its written prediction.
- What you could not verify.
Quality check
- Every number in the report has a source and a date in the same sentence.
- Prompt wording matches last month's exactly, or the change is logged and the comparison marked broken.
- Each prompt was run at least twice per engine, on different days.
- Differences under the noise band (see
references/reading-results.md) are labeled as noise. - Null data is written "not in the data".
- Only one lever changed this month, and its prediction was written before the month started.
- The report says that no published benchmark defines a good Reddit presence rate, so the user's own baseline is the bar.
- The report says that a cited thread doesn't prove an engine used your comment in it; only an answer that repeats your comment's point or names your product shows that.
- The report defines each metric it uses (presence rate, source share, subreddit share, brand-in-answer rate) in one line.
- Any reply the user posted carried a disclosure.
What to avoid
- Reporting one run of one prompt as a trend.
- Quoting a benchmark you cannot link. If the user asks "what is a good Reddit presence rate", say none exists here, and offer to set their own baseline.
- Comparing the CommunityMentions counts with your own prompt runs as if they measure the same thing. One counts citations in many answers collected by that dataset, the other counts what your 30 prompts return.
- Crediting a lift to your Reddit work without a comparison. Keep a set of prompts and threads you do not touch.
- Buying upvotes, using extra accounts, or hiding your tie to move a count. It breaks Reddit's rules and the subreddit's, and a removed thread drops out of the answers anyway.
Related Skills
- reddit-context: holds the buyer prompts, competitors and disclosure line this skill reads.
- subreddit-research: picks the subreddits to measure and checks their rules and fit.
- ai-cited-threads: acts on single threads: scoring them and writing the reply that fills the gap.
- reddit-listening: catches new threads for your prompts between monthly runs.
- reddit-comments: writes the replies that this skill's levers call for.
- reddit-ads: use when an ad, not a comment, is the right way to reach the same buyers.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

