New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Reddit Reading

by Luciole-Studio in Luciole-Studio/Misaka-Agent

Read Reddit: subreddits, search, threads, users. An agent skill from Luciole-Studio/Misaka-Agent.

MITAuto-check: notes

Install Reddit Reading

skills CLI
$ npx skills add Luciole-Studio/Misaka-Agent --skill reddit-reading -a claude-code

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

GitHub CLI
$ gh skill install Luciole-Studio/Misaka-Agent reddit-reading --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/Luciole-Studio/Misaka-Agent.git skills-src && mkdir -p .claude/skills && cp -r skills-src/misaka/core/skills/assets/optional/social-media/reddit-reading .claude/skills/reddit-reading && 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/

Facts

Skill name
reddit-reading
GitHub stars
158
Used in
1 other repo
Token cost
~1.6k tokens
SKILL.md length
774 words
Files
2 (incl. scripts)
Skills in repo
77
Repo updated
First seen
Licence
MIT

At a glance

Read Reddit: subreddits, search, threads, users. An agent skill from Luciole-Studio/Misaka-Agent.

  • SKILL.md covers When to Use, Prerequisites, How to Run and Quick Reference, plus 3 more sections
  • Runs Python scripts from its folder; calls python3; reaches reddit.com; needs REDDIT_CLIENT_SECRET

What it does

Reddit Reading is an agent skill from Luciole-Studio/Misaka-Agent. Read Reddit: subreddits, search, threads, users. No browser.

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including scripts (for example `scripts/reddit.py`).

It works with Reddit. The repository describes itself as: A multi-agent research system for the humanities and social sciences. The licence is MIT.

Example prompts

  • “/reddit-reading”

Requirements

  • Python 3
  • A credential in REDDIT_CLIENT_SECRET

What it can do on your machine

Read from SKILL.md and the folder at commit 3bcf7a3. 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

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • reddit.com

    Also links to:

    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • REDDIT_CLIENT_SECRET

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

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

Always · name and description, kept in context so the agent knows when to use it
~19
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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:39
    two values in `~/.hermes/.env`:
  • NoteMentions a .env fileSKILL.md:54
    othing | 1-minute app registration, two `.env` values |

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); the scripts in this folder are not scanned.

SKILL.md

The full file from Luciole-Studio/Misaka-Agent at commit 3bcf7a3, republished under its MIT licence (© Luciole-Studio). 774 words, ~1,558 tokens.

Download SKILL.mdSave it as .claude/skills/reddit-reading/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
reddit-reading
description
Read Reddit: subreddits, search, threads, users. No browser.
version
1.0.0
author
Teknium (teknium1), Hermes Agent
license
MIT
platforms
linux, macos, windows

Reddit Reading Skill

Reads Reddit content — subreddit listings, site or subreddit search, full threads with comments, and user activity — from a server or headless machine where the normal routes are dead. It does not post, vote, or log in as a user. Idea credit: the per-platform backend routing in Agent Reach.

When to Use

  • "What is r/LocalLLaMA saying about X", "find Reddit threads on Y", "summarise this Reddit thread", "what has u/someone posted lately".
  • Any reddit.com URL the user shares. web_extract, browser_navigate and the .json endpoints all fail from server IPs (403 or a "Prove your humanity" wall); this skill is the working path.
  • Not for posting, voting, messaging, or anything needing a user login.

Prerequisites

None. No Reddit account, login, cookie, or API key is needed. The default backend is Reddit's public Atom feeds (.rss endpoints), the only unauthenticated route Reddit still serves to non-residential IPs. It is throttled to about one request per minute per IP and returns thinner data (no scores, top-level comments only), which is fine for a few calls.

Optional upgrade (app credentials, still no user login): for sustained use or full data, register a free "script" type app at https://www.reddit.com/prefs/apps and put its two values in ~/.hermes/.env:

REDDIT_CLIENT_ID=...
REDDIT_CLIENT_SECRET=...

This is an application registration, not a login: the script uses the app-only client_credentials grant, never a username, password, or browser cookie, and never acts as the user. With both values set it switches to the OAuth API automatically (~100 requests per minute, scores, nested comments, num_comments); if they are missing or rejected it falls back to the anonymous feeds and says so on stderr.

Anonymous feeds (default)OAuth app credentials
Setupnothing1-minute app registration, two .env values
Rate limit~1 request / minute / IP~100 requests / minute
Thread datapost + top-level comments, no scoresnested comments, scores, comment counts
Acts as a usernono

How to Run

Run every command through terminal with the skill-relative script path:

bash
python3 scripts/reddit.py doctor                                  # which backend, current rate-limit window
python3 scripts/reddit.py sub LocalLLaMA --sort hot --limit 15
python3 scripts/reddit.py search "hermes agent" --sub LocalLLaMA --sort new
python3 scripts/reddit.py thread https://www.reddit.com/r/x/comments/abc123/slug/ --limit 40
python3 scripts/reddit.py user spez --limit 10
python3 scripts/reddit.py --json search "topic"                  # machine-readable

Quick Reference

Every command works on both backends; the script chooses the backend, you never pass a flag.

NeedCommandAnonymousOAuth
Subreddit front pagesub NAME --sort hot|new|top|rising [--time week]✔✔
Search all of Redditsearch "q" --sort relevance|new|top|comments✔✔
Search one subredditsearch "q" --sub NAME✔✔
Thread + commentsthread URL --limit N✔ top-level only, no scores✔ nested, scores
User posts/commentsuser NAME✔✔
Backend + rate limitdoctor✔✔
Show full SKILL.md (386 more words)Show less

Procedure

① doctor once per task if you have not called it this session — it tells you which backend is live and how many seconds remain in the anonymous window.

② Plan your calls before making them. Anonymous Reddit allows roughly one request per minute per IP; the script sleeps until the window resets on a 429 and retries once, so a five-call plan costs about five minutes. Prefer one search --sub over several sub listings, and read one thread rather than the whole listing.

③ For "what is the community saying" questions, read the thread bodies (thread) rather than stopping at titles; the listing only carries the first ~300 characters of each post.

④ Cite the permalink (url field), not the listing page, when the result feeds a report. grounded-citations registers these URLs like any other source.

⑤ If the user needs sustained Reddit access (monitoring, more than ~10 calls), stop and ask them to register the app credentials (Prerequisites) rather than grinding through the throttle. Tell them plainly: it is a free app registration, not logging Hermes into their account. Never ask for a Reddit password or browser cookies.

Pitfalls

  • www.reddit.com/…/.json, api.reddit.com and old.reddit.com return 403 or an empty "Welcome to Reddit" shell for datacentre IPs. Do not fall back to them; do not spoof a browser User-Agent (also 403).
  • r.jina.ai and the browser_navigate tool hit the same block ("blocked by network security" / humanity check). blocked-page-recovery's Wayback route can still recover an old thread that was archived; it cannot fetch fresh ones.
  • Anonymous thread feeds only contain the post plus top-level comments (Reddit caps the feed at a handful of entries); scores and reply nesting are OAuth-only.
  • Reddit's limit on feeds is advisory — expect 5–25 entries regardless of what you ask.
  • Never paste REDDIT_CLIENT_SECRET into a chat or log; the script reads it from the environment only.
  • Do not "fix" a 429 by retrying in a loop or adding a proxy; the throttle is per IP and the script already waits out the window once. More than one 429 in a row means the task needs the app credentials.

Verification

python3 scripts/reddit.py doctor prints anonymous_feed: ok and an x-ratelimit-reset value; sub announcements --limit 1 returns one entry with a reddit.com/r/announcements/comments/ URL. With credentials set, doctor prints active_backend: oauth and thread … output shows numeric scores.

© Luciole-Studio, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (scripts) in misaka/core/skills/assets/optional/social-media/reddit-reading of Luciole-Studio/Misaka-Agent.

  • SKILL.md
  • scripts/reddit.py

Open the folder on GitHubat commit 3bcf7a3

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in Luciole-Studio/Misaka-Agent, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Reddit Reading 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 Reading compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Reddit Reading this skillLuciole-Studio/Misaka-Agent1581 repos~1.6kAutomated safety check: NotesMIT
Agent ReachPanniantong/Agent-Reach94k—~1.4kAutomated safety check: PassMIT
Last30daysmvanhorn/last30days-skill64k—~7.9kAutomated safety check: NotesMIT
Customer ResearchNexus-JPF/note-companion8706 repos~3.2kAutomated safety check: PassMIT
Last30days CnJesseovo/last30days-skill-cn1.9k—~2.4kAutomated safety check: NotesMIT
Reddit JSON Fetcherykdojo/claude-code-tips10k—~1.4kAutomated safety check: PassCustom licence

Similar skills

  • Agent Reach

    Panniantong/Agent-Reach

    Routes web research and platform lookups across 16 sites, including Twitter, Reddit, YouTube, Bilibili, Xiaohongshu and GitHub, through one command-line tool.

    94k GitHub stars~1.4k tokensUpdated yesterday
    Productivity & AutomationAuto-check passed

  • Last30days

    mvanhorn/last30days-skill

    Research what people actually say about any topic in the last 30 days.

    64k GitHub stars~7.9k tokensUpdated today
    Research & ScienceAuto-check: notes

  • 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

  • Last30days Cn

    Jesseovo/last30days-skill-cn

    Research what Chinese internet users actually said in the last 30 days across Weibo, Xiaohongshu (RED), Bilibili, Zhihu, Douyin, WeChat public accounts, Baidu and Toutiao: engagement-weighted…

    1.9k GitHub stars~2.4k tokensUpdated 3 days ago
    Productivity & AutomationAuto-check: notes

  • Reddit JSON Fetcher

    ykdojo/claude-code-tips

    Fetches Reddit posts, threads and search results as JSON through a browser session, using a DuckDuckGo redirect to get past Reddit's automated-access block.

    10k GitHub stars~1.4k tokensUpdated 14 days ago
    Productivity & AutomationAuto-check passed

  • bb-browser Site Commands for OpenClaw

    epiral/bb-browser

    Runs structured data commands against sites such as Twitter, Reddit, GitHub, YouTube and Zhihu through OpenClaw's browser, reusing your existing login state.

    6.2k GitHub stars~1k tokensUpdated 4 mo ago
    Productivity & AutomationAuto-check passed

More from Luciole-Studio/Misaka-Agent

All 77 skills in this repo

  • Kanban Video Orchestrator

    Luciole-Studio/Misaka-Agent

    Plan and run multi-agent video production pipelines. An agent skill from Luciole-Studio/Misaka-Agent.

    158 GitHub starsUsed in 2 repos~2.4k tokens
    Auto-check: notes

  • Ast Grep

    Luciole-Studio/Misaka-Agent

    AST-aware structural code search and rewrite via ast-grep. An agent skill from Luciole-Studio/Misaka-Agent.

    158 GitHub starsUsed in 1 repo~3.2k tokens
    Auto-check passed

  • Drug Discovery

    Luciole-Studio/Misaka-Agent

    Drug discovery: ChEMBL search, drug-likeness, interactions. An agent skill from Luciole-Studio/Misaka-Agent.

    158 GitHub starsUsed in 1 repo~2.2k tokens
    Auto-check passed

  • Fitness Nutrition

    Luciole-Studio/Misaka-Agent

    Workout planning, macros, and body metrics via wger/USDA. An agent skill from Luciole-Studio/Misaka-Agent.

    158 GitHub starsUsed in 1 repo~2.4k tokens
    Auto-check passed

  • Hyperframes

    Luciole-Studio/Misaka-Agent

    Render MP4/WebM videos from HTML compositions. An agent skill from Luciole-Studio/Misaka-Agent.

    158 GitHub starsUsed in 1 repo~3.9k tokens
    Auto-check passed

  • Osint Investigation

    Luciole-Studio/Misaka-Agent

    Follow the money via public records and sanctions data. An agent skill from Luciole-Studio/Misaka-Agent.

    158 GitHub starsUsed in 1 repo~2.9k tokens
    Auto-check passed

Works with

Questions about Reddit Reading

What does Reddit Reading do?

Read Reddit: subreddits, search, threads, users. An agent skill from Luciole-Studio/Misaka-Agent. Reddit Reading is an agent skill from Luciole-Studio/Misaka-Agent. Read Reddit: subreddits, search, threads, users.

How do I install Reddit Reading in Claude Code?

Run `npx skills add Luciole-Studio/Misaka-Agent --skill reddit-reading -a claude-code`. Or copy the skill folder (misaka/core/skills/assets/optional/social-media/reddit-reading in Luciole-Studio/Misaka-Agent) into .claude/skills/reddit-reading in your project. Claude Code loads it when a task matches its description.

How do I install Reddit Reading in Codex?

Run `npx skills add Luciole-Studio/Misaka-Agent --skill reddit-reading -a codex`. Or copy the skill folder (misaka/core/skills/assets/optional/social-media/reddit-reading in Luciole-Studio/Misaka-Agent) into .agents/skills/reddit-reading in your project. Codex loads it when a task matches its description.

Can I use Reddit Reading 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 Luciole-Studio/Misaka-Agent --skill reddit-reading -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-reading, .gemini/skills/reddit-reading, .github/skills/reddit-reading and .opencode/skills/reddit-reading in your project.

What does Reddit Reading need to run?

Going by SKILL.md and its folder, Reddit Reading needs Python for the scripts in its folder, the command-line tools its instructions call (python3) and credentials named REDDIT_CLIENT_SECRET. Our summary lists: Python 3; A credential in REDDIT_CLIENT_SECRET.

Does Reddit Reading access the network?

SKILL.md names 2 domains. In commands or code: reddit.com; the agent is likely to contact it when it follows the instructions. As links in the text: github.com. This is read from the text; nothing was executed.

Is Reddit Reading safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Reddit Reading use?

Reddit Reading 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 Reading use?

About 1.6k tokens (SKILL.md is roughly 6.2k 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 Reading?

Skills that share tags, products or a category with Reddit Reading: Agent Reach (Panniantong/Agent-Reach, 94k stars), Last30days (mvanhorn/last30days-skill, 64k stars), Customer Research (Nexus-JPF/note-companion, 870 stars) and Last30days Cn (Jesseovo/last30days-skill-cn, 1.9k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Reddit Reading?

Luciole-Studio (a GitHub organization) maintains it in Luciole-Studio/Misaka-Agent, which has 158 GitHub stars. The repository holds 77 skills in this directory. The repository was last updated on October 8, 2026.

Source: Luciole-Studio/Misaka-Agent on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.