Reddit skill for Claude Code & Codex

Agent skill

by unifapi-agent in unifapi-agent/agents

When a workflow needs public Reddit data through UnifAPI — subreddit profiles and rules, thread comment trees, user activity and karma, the home/news/popular feeds, or trending searches.

MITAuto-check passedMarketing & SEO

Install Reddit

skills CLI

$ npx skills add unifapi-agent/agents --skill reddit -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install unifapi-agent/agents reddit --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/unifapi-agent/agents.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/reddit-agent/reddit .claude/skills/reddit && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "reddit" agent skill from https://github.com/unifapi-agent/agents/tree/main/skills/reddit-agent/reddit into .claude/skills/reddit/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "reddit", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/unifapi-agent/agents/tree/main/skills/reddit-agent/reddit

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add unifapi-agent/agents --skill reddit -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install unifapi-agent/agents reddit --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/unifapi-agent/agents.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/reddit-agent/reddit .agents/skills/reddit && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "reddit" agent skill from https://github.com/unifapi-agent/agents/tree/main/skills/reddit-agent/reddit into .agents/skills/reddit/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "reddit", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add unifapi-agent/agents --skill reddit -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install unifapi-agent/agents reddit --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/unifapi-agent/agents.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/reddit-agent/reddit .cursor/skills/reddit && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "reddit" agent skill from https://github.com/unifapi-agent/agents/tree/main/skills/reddit-agent/reddit into .cursor/skills/reddit/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "reddit", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/unifapi-agent/agents.git --path skills/reddit-agent/reddit

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add unifapi-agent/agents --skill reddit -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install unifapi-agent/agents reddit --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/unifapi-agent/agents.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/reddit-agent/reddit .gemini/skills/reddit && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "reddit" agent skill from https://github.com/unifapi-agent/agents/tree/main/skills/reddit-agent/reddit into .gemini/skills/reddit/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "reddit", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install unifapi-agent/agents reddit

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add unifapi-agent/agents --skill reddit -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/unifapi-agent/agents.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/reddit-agent/reddit .github/skills/reddit && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "reddit" agent skill from https://github.com/unifapi-agent/agents/tree/main/skills/reddit-agent/reddit into .github/skills/reddit/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "reddit", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add unifapi-agent/agents --skill reddit -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install unifapi-agent/agents reddit --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/unifapi-agent/agents.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/reddit-agent/reddit .opencode/skills/reddit && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "reddit" agent skill from https://github.com/unifapi-agent/agents/tree/main/skills/reddit-agent/reddit into .opencode/skills/reddit/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "reddit", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: reddit
GitHub stars: 587
Token cost: ~1.6k tokens
SKILL.md length: 599 words
Files: 2
Skills in repo: 47
Repo updated: Sep 5, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

When a workflow needs public Reddit data through UnifAPI — subreddit profiles and rules, thread comment trees, user activity and karma, the home/news/popular feeds, or trending searches.

Works in 6 steps: Seed the communities. Reddit has no… → Discover threads. Scan… → Mine a thread. With a post id, call… → …
Tasks that involve Social media marketing
SKILL.md covers Use the unifapi skill for live…, Response contract, Core operations and Workflow, plus 4 more sections
Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Reddit is an agent skill from unifapi-agent/agents. When a workflow needs public Reddit data through UnifAPI — subreddit profiles and rules, thread comment trees, user activity and karma, the home/news/popular feeds, or trending searches. Also use on "research this subreddit," "what does r/... discuss," "pull this Reddit thread," "Reddit user activity," or when another skill (community research, social listening, customer research) needs the deterministic Reddit read path. Reddit has no keyword search — discovery is seed-driven. Connect via the unifapi skill…

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `README.md`).

It sits in Marketing & SEO, covering Social media marketing and Market research. It works with Reddit. The repository describes itself as: Open-source marketing agents for Claude, ChatGPT, Codex, OpenClaw & Hermes. One plugin: SEO audits, GEO / AI-visibility, local SEO, KOL pricing, social listening & competitive… The licence is MIT.

When your agent uses it

Tasks that involve Social media marketing
Tasks that involve Market research

Example prompts

“research this subreddit,”
“what does r/... discuss,”
“pull this Reddit thread,”
“/reddit”

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

Seed the communities. Reddit has no keyword search, so name the subreddits
Discover threads. Scan reddit/feed/popular, reddit/feed/news, and
Mine a thread. With a post id, call reddit/posts/{id} for the post and
Track power users. Call reddit/users/{username} for karma, then
Flag outreach safety. Read each subreddit's rules from description and
Cite everything. Every quote ties back to its thread or comment; state

What it can do on your machine

Read from SKILL.md and the folder at commit fb53247. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md (its code samples are json and markdown).
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Reddit loads about 1.6k tokens when it runs. Until then it costs about 140 tokens; SKILL.md has 599 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~140
When it runs · the whole SKILL.md, loaded when a task matches: ~1.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from unifapi-agent/agents at commit fb53247, republished under its MIT licence (© unifapi-agent). 599 words, ~1,626 tokens.

Download SKILL.mdSave it as .claude/skills/reddit/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.

name: reddit
description: When a workflow needs public Reddit data through UnifAPI — subreddit profiles and rules, thread comment trees, user activity and karma, the home/news/popular feeds, or trending searches. Also use on "research this subreddit," "what does r/... discuss," "pull this Reddit thread," "Reddit user activity," or when another skill (community research, social listening, customer research) needs the deterministic Reddit read path. Reddit has no keyword search — discovery is seed-driven. Connect via the `unifapi` skill first. Read-only research, never posts.
license: MIT
metadata.author: UnifAPI
metadata.version: 1.0.0
metadata.homepage: https://unifapi.com/agents/reddit
metadata.source: https://github.com/unifapi-agent/agents

The deterministic read path for public Reddit data through UnifAPI. This is a Data Skill: it does not run a marketing job on its own — it names the concrete reddit/... operations, response shapes, and the real coverage limits so any community-first workflow (social listening, voice-of-customer) reads from one known, honest recipe instead of rediscovering the surface each time.

Read-only — eyes, not hands. It researches public Reddit data and returns cited records; it never posts, comments, or votes, and UnifAPI never holds Reddit credentials.

Use the `unifapi` skill for live evidence

Connect once through the shared unifapi skill (OAuth MCP), then call the operations below. Reddit's public surface has no keyword search, so discovery is seed-driven — say so in the output. Keep any billing metadata so the output can state record cost.

Response contract

Single-entity endpoints return the object in data:

json

{
  "request_id": "unif_...",
  "data": {},
  "billing": { "records_charged": 1, "balance_remaining": 99 }
}

List endpoints return an array in data plus pagination:

json

{
  "request_id": "unif_...",
  "data": [],
  "pagination": { "has_more": false, "next_cursor": null },
  "billing": { "records_charged": 1 }
}

When pagination.has_more is true, pass pagination.next_cursor as the next request's cursor. Always preserve billing when reporting cost.

Core operations

Need	Operation
Subreddit profile + rules	`reddit/subreddits/{name}`
Discover threads	`reddit/feed/popular` · `reddit/feed/news` · `reddit/feed/home`
Trending searches	`reddit/trending-searches`
Post by id	`reddit/posts/{id}`
Comment tree on a thread	`reddit/posts/{id}/comments`
User profile + karma	`reddit/users/{username}`
User posts / comments	`reddit/users/{username}/posts` · `.../comments`

Need a field not listed here? Use the unifapi skill's get_operation to read the exact schema before calling — but pick the operation from this table, don't discover blind.

Workflow

The deterministic recipes. Pick the one that matches the job; each names exactly what to call.

Seed the communities. Reddit has no keyword search, so name the subreddits the audience lives in and call reddit/subreddits/{name} for subscribers_count, active_count, is_nsfw, and the rules in description.
Discover threads. Scan reddit/feed/popular, reddit/feed/news, and reddit/feed/home, plus reddit/trending-searches, and keep the posts whose subreddit field matches your seeds — that is how you find community threads without a per-subreddit feed.
Mine a thread. With a post id, call reddit/posts/{id} for the post and reddit/posts/{id}/comments for the comment tree; capture the upvoted (score) verbatim language. Page via next_cursor.
Track power users. Call reddit/users/{username} for karma, then .../posts and .../comments for what an active member contributes across the niche.
Flag outreach safety. Read each subreddit's rules from description and is_nsfw before suggesting any participation.
Cite everything. Every quote ties back to its thread or comment; state plainly that coverage is seed-driven, not exhaustive, and report billing.records_charged.

Show full SKILL.md (204 more words)Show less

Shape notes

RedditSubreddit — keyed by {name}. subscribers_count, active_count, is_nsfw, description (carries rules), prefixed_name (r/...).
RedditPost — title, url, text, created_at, subreddit, is_stickied, is_locked, is_nsfw. Use the subreddit field to filter feed results back to a community.
RedditComment — text, score (upvotes), author_name, is_locked.
RedditUser — name, karma_total, karma_from_posts, karma_from_comments, is_verified, is_employee.

Gotchas

No keyword search. You cannot query Reddit by term — discovery comes from the global feed/* endpoints, trending-searches, and the subreddits/users you already name. Say so in the brief.
No per-subreddit post feed. reddit/subreddits/{name} returns the profile and rules only; to read a community's threads, filter the global feeds by the subreddit field, start from a known post id, or read active users' posts.
A low balance can silently truncate list pages: check billing.truncated_due_to_balance — when true the page is partial.

Output

Return the records the calling workflow needs, each cited to its thread or comment, plus a one-line cost note (records_charged). When this skill is used directly, a compact community brief is the default:

markdown

**r/{subreddit}** — {subscribers} subscribers, {active} active. Recurring questions: {themes}. Verbatim: "{quote}" ({score} upvotes). Outreach rules: {note}. Coverage: seed-driven. Evidence: {URLs}. Records: ~{N}.

reddit-community-research (Lead & Company Research) — turns this read path into a structured community map.
social-listening-brief (Social Listening), customer-research — listening and voice-of-customer work on top of Reddit reads.
unifapi — the shared data skill: connect MCP and look up exact schemas with get_operation.

Files

SKILL.md and 1 other file in skills/reddit-agent/reddit of unifapi-agent/agents.

SKILL.md
README.md

Open the folder on GitHubat commit fb53247

Compare with similar skills

Reddit next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Reddit compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Reddit this skillunifapi-agent/agents	587	—	~1.6k	Automated safety check: Pass	MIT	1 mo ago
Reddit Competitor Analysis API Skillbrowser-act/skills	6.1k	2 repos	~1.7k	Automated safety check: Pass	MIT	1 mo ago
Blog DiscourseAgriciDaniel/claude-blog	2.3k	1 repos	~3.4k	Automated safety check: Warn	MIT	today
Customer ResearchNexus-JPF/note-companion	870	6 repos	~3.2k	Automated safety check: Pass	MIT	yesterday
Bggg Data Redditbinggandata/bggg-skills	603	—	~1.2k	Automated safety check: Pass	MIT	1 mo ago
Reddit InsightsBrianRWagner/ai-marketing-claude-code-skills	440	2 repos	~3.1k	Automated safety check: Pass	None	6 mo ago

Similar skills

Reddit Competitor Analysis API Skill
browser-act/skills
This skill helps users extract structured data from Reddit posts and comments via BrowserAct API.
6.1k GitHub starsUsed in 2 repos~1.7k tokens
Marketing & SEOAuto-check passed
Blog Discourse
AgriciDaniel/claude-blog
Research what people are actually saying about a topic in the last 30 days across Reddit, X / Twitter, YouTube, Hacker News, dev.to, Medium, and other public discourse platforms.
2.3k GitHub starsUsed in 1 repo~3.4k tokens
Marketing & SEOAuto-check: warnings
Customer Research
Nexus-JPF/note-companion
When the user wants to conduct, analyze, or synthesize customer research.
870 GitHub starsUsed in 6 repos~3.2k tokens
Marketing & SEOAuto-check passed
Bggg Data Reddit
binggandata/bggg-skills
Collect auditable Reddit search results and full comment trees at scale, preserve the source JSON, and normalize posts and comments into analysis-ready JSONL.
603 GitHub stars~1.2k tokensUpdated 1 mo ago
Marketing & SEOAuto-check passed
Reddit Insights
BrianRWagner/ai-marketing-claude-code-skills
Search and analyze Reddit content using semantic AI search via reddit-insights.com MCP server.
440 GitHub starsUsed in 2 repos~3.1k tokens
Marketing & SEOAuto-check passed
reddapi Reddit Search
lignertys/reddit-research-skills
Searches Reddit through the reddapi.dev indexer with two search modes, trend queries and subreddit lookup, with no Reddit OAuth or app registration.
1.3k GitHub starsUsed in 1 repo~3.6k tokens
Marketing & SEOAuto-check: warnings

More from unifapi-agent/agents

All 47 skills in this repo

LLM Mention Tracking
unifapi-agent/agents
When the user wants to track how often their brand or domain gets mentioned across ChatGPT and AI search engines over a set of prompts, and how that share of voice compares to named competitors over…
587 GitHub stars~1.8k tokensUpdated 1 mo ago
Auto-check passed
Buying Signal Monitor
unifapi-agent/agents
When a seller or SDR wants to catch public buying intent on X/Twitter and LinkedIn — someone asking for a tool they sell, complaining about or switching off a competitor, or hiring for a role that…
587 GitHub stars~2.4k tokensUpdated 1 mo ago
Auto-check passed
Customer Research
unifapi-agent/agents
When the user wants to research customers from public communities, or synthesize customer language, pains, and objections.
587 GitHub stars~2.1k tokensUpdated 1 mo ago
Auto-check passed
Keyword Research
unifapi-agent/agents
When the user wants to research keywords, find keyword opportunities, run a keyword gap analysis, build topic clusters, or compare what competitors rank for.
587 GitHub stars~2.7k tokensUpdated 1 mo ago
Auto-check passed
Schema
unifapi-agent/agents
When the user wants to add, fix, or optimize schema markup and structured data on their site.
587 GitHub stars~2.1k tokensUpdated 1 mo ago
Auto-check passed
SEO Audit
unifapi-agent/agents
When the user wants to audit, review, or diagnose SEO issues on their site.
587 GitHub stars~3.4k tokensUpdated 1 mo ago
Auto-check passed

Works with

Questions about Reddit

What does Reddit do?

When a workflow needs public Reddit data through UnifAPI — subreddit profiles and rules, thread comment trees, user activity and karma, the home/news/popular feeds, or trending searches. Reddit is an agent skill from unifapi-agent/agents. When a workflow needs public Reddit data through UnifAPI — subreddit profiles and rules, thread comment trees, user activity and karma, the home/news/popular feeds, or trending searches.

When should I use Reddit?

Reddit fits situations like: tasks that involve Social media marketing; tasks that involve Market research.

How do I install Reddit in Claude Code?

Run `npx skills add unifapi-agent/agents --skill reddit -a claude-code`. Or copy the skill folder (skills/reddit-agent/reddit in unifapi-agent/agents) into .claude/skills/reddit in your project. Claude Code loads it when a task matches its description.

How do I install Reddit in Codex?

Run `npx skills add unifapi-agent/agents --skill reddit -a codex`. Or copy the skill folder (skills/reddit-agent/reddit in unifapi-agent/agents) into .agents/skills/reddit in your project. Codex loads it when a task matches its description.

Can I use Reddit in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add unifapi-agent/agents --skill reddit -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/reddit, .gemini/skills/reddit, .github/skills/reddit and .opencode/skills/reddit in your project.

What does Reddit need to run?

SKILL.md names no scripts, command-line tools or credentials: Reddit is instructions for the agent only.

Does Reddit access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Reddit safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Reddit use?

Reddit is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Reddit use?

About 1.6k tokens (SKILL.md is roughly 6.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Reddit?

Skills that share tags, products or a category with Reddit: Reddit Competitor Analysis API Skill (browser-act/skills, 6.1k stars), Blog Discourse (AgriciDaniel/claude-blog, 2.3k stars), Customer Research (Nexus-JPF/note-companion, 870 stars) and Bggg Data Reddit (binggandata/bggg-skills, 603 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Reddit?

unifapi-agent (a GitHub organization) maintains it in unifapi-agent/agents, which has 587 GitHub stars. The repository holds 47 skills in this directory. The repository was last updated on September 5, 2026.

Source: unifapi-agent/agents on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Reddit

Facts

At a glance

What it does

When your agent uses it

Example prompts

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

reddit

Use the unifapi skill for live evidence

Response contract

Core operations

Workflow

Shape notes

Gotchas

Output

Related skills

Files

Compare with similar skills

Similar skills

More from unifapi-agent/agents

Related

Questions about Reddit

Use the `unifapi` skill for live evidence