[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M737TBH18G19KCPA27JS8358":3,"skill-same:01M737TBH18G19KCPA27JS8358":69},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":42,"commitSha":43,"skillDirectory":44,"forksCount":45,"repositoryHtmlUrl":46,"repositoryHomepageUrl":6,"ownerHtmlUrl":47,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":48,"install":49,"resources":62},"01M737TBH18G19KCPA27JS8358","reddit-reading",null,"Read Reddit: subreddits, search, threads, users. No browser.","ashneil12\u002Fvanilla-hermes-agent-canary","ashneil12","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F49880658?v=4","01M7378BQ9W161EPENEWBYAQNN","01M7378BRDJG8SFS93FG4V6BWY",1,"MIT","https:\u002F\u002Fgithub.com\u002Fashneil12\u002Fvanilla-hermes-agent-canary\u002Fblob\u002Fmain\u002Foptional-skills\u002Fsocial-media\u002Freddit-reading\u002FSKILL.md",[],[],"2026-11-11 15:11:14",false,"---\nname: reddit-reading\ndescription: \"Read Reddit: subreddits, search, threads, users. No browser.\"\nversion: 1.0.0\nauthor: Teknium (teknium1), Hermes Agent\nlicense: MIT\nplatforms: [linux, macos, windows]\nmetadata:\n  hermes:\n    tags: [Reddit, Social Media, Research, Discussions, Community]\n    related_skills: [rss-feeds, grounded-citations, blocked-page-recovery, xurl]\n---\n\n# Reddit Reading Skill\n\nReads Reddit content — subreddit listings, site or subreddit search, full threads with\ncomments, and user activity — from a server or headless machine where the normal routes\nare dead. It does not post, vote, or log in as a user. Idea credit: the per-platform\nbackend routing in [Agent Reach](https:\u002F\u002Fgithub.com\u002FPanniantong\u002FAgent-Reach).\n\n## When to Use\n\n- \"What is r\u002FLocalLLaMA saying about X\", \"find Reddit threads on Y\", \"summarise this\n  Reddit thread\", \"what has u\u002Fsomeone posted lately\".\n- Any `reddit.com` URL the user shares. `web_extract`, `browser_navigate` and the\n  `.json` endpoints all fail from server IPs (403 or a \"Prove your humanity\" wall);\n  this skill is the working path.\n- Not for posting, voting, messaging, or anything needing a user login.\n\n## Prerequisites\n\n**None.** No Reddit account, login, cookie, or API key is needed. The default backend is\nReddit's public Atom feeds (`.rss` endpoints), the only unauthenticated route Reddit still\nserves to non-residential IPs. It is throttled to about one request per minute per IP and\nreturns thinner data (no scores, top-level comments only), which is fine for a few calls.\n\n**Optional upgrade (app credentials, still no user login):** for sustained use or full\ndata, register a free \"script\" type app at https:\u002F\u002Fwww.reddit.com\u002Fprefs\u002Fapps and put its\ntwo values in `~\u002F.hermes\u002F.env`:\n\n```\nREDDIT_CLIENT_ID=...\nREDDIT_CLIENT_SECRET=...\n```\n\nThis is an application registration, not a login: the script uses the app-only\n`client_credentials` grant, never a username, password, or browser cookie, and never\nacts as the user. With both values set it switches to the OAuth API automatically\n(~100 requests per minute, scores, nested comments, `num_comments`); if they are\nmissing or rejected it falls back to the anonymous feeds and says so on stderr.\n\n| | Anonymous feeds (default) | OAuth app credentials |\n|---|---|---|\n| Setup | nothing | 1-minute app registration, two `.env` values |\n| Rate limit | ~1 request \u002F minute \u002F IP | ~100 requests \u002F minute |\n| Thread data | post + top-level comments, no scores | nested comments, scores, comment counts |\n| Acts as a user | no | no |\n\n## How to Run\n\nRun every command through `terminal` with the skill-relative script path:\n\n```bash\npython3 scripts\u002Freddit.py doctor                                  # which backend, current rate-limit window\npython3 scripts\u002Freddit.py sub LocalLLaMA --sort hot --limit 15\npython3 scripts\u002Freddit.py search \"hermes agent\" --sub LocalLLaMA --sort new\npython3 scripts\u002Freddit.py thread https:\u002F\u002Fwww.reddit.com\u002Fr\u002Fx\u002Fcomments\u002Fabc123\u002Fslug\u002F --limit 40\npython3 scripts\u002Freddit.py user spez --limit 10\npython3 scripts\u002Freddit.py --json search \"topic\"                  # machine-readable\n```\n\n## Quick Reference\n\nEvery command works on both backends; the script chooses the backend, you never pass a flag.\n\n| Need | Command | Anonymous | OAuth |\n|---|---|---|---|\n| Subreddit front page | `sub NAME --sort hot\\|new\\|top\\|rising [--time week]` | ✔ | ✔ |\n| Search all of Reddit | `search \"q\" --sort relevance\\|new\\|top\\|comments` | ✔ | ✔ |\n| Search one subreddit | `search \"q\" --sub NAME` | ✔ | ✔ |\n| Thread + comments | `thread URL --limit N` | ✔ top-level only, no scores | ✔ nested, scores |\n| User posts\u002Fcomments | `user NAME` | ✔ | ✔ |\n| Backend + rate limit | `doctor` | ✔ | ✔ |\n\n## Procedure\n\n① `doctor` once per task if you have not called it this session — it tells you which\nbackend is live and how many seconds remain in the anonymous window.\n\n② Plan your calls before making them. Anonymous Reddit allows roughly **one request per\nminute per IP**; the script sleeps until the window resets on a 429 and retries once, so\na five-call plan costs about five minutes. Prefer one `search --sub` over several `sub`\nlistings, and read one thread rather than the whole listing.\n\n③ For \"what is the community saying\" questions, read the thread bodies (`thread`) rather\nthan stopping at titles; the listing only carries the first ~300 characters of each post.\n\n④ Cite the permalink (`url` field), not the listing page, when the result feeds a report.\n`grounded-citations` registers these URLs like any other source.\n\n⑤ If the user needs sustained Reddit access (monitoring, more than ~10 calls), stop and\nask them to register the app credentials (Prerequisites) rather than grinding through the\nthrottle. Tell them plainly: it is a free app registration, not logging Hermes into their\naccount. Never ask for a Reddit password or browser cookies.\n\n## Pitfalls\n\n- `www.reddit.com\u002F…\u002F.json`, `api.reddit.com` and `old.reddit.com` return 403 or an\n  empty \"Welcome to Reddit\" shell for datacentre IPs. Do not fall back to them; do not\n  spoof a browser User-Agent (also 403).\n- `r.jina.ai` and the `browser_navigate` tool hit the same block (\"blocked by network\n  security\" \u002F humanity check). `blocked-page-recovery`'s Wayback route can still recover\n  an **old** thread that was archived; it cannot fetch fresh ones.\n- Anonymous thread feeds only contain the post plus top-level comments (Reddit caps the\n  feed at a handful of entries); scores and reply nesting are OAuth-only.\n- Reddit's `limit` on feeds is advisory — expect 5–25 entries regardless of what you ask.\n- Never paste `REDDIT_CLIENT_SECRET` into a chat or log; the script reads it from the\n  environment only.\n- Do not \"fix\" a 429 by retrying in a loop or adding a proxy; the throttle is per IP and\n  the script already waits out the window once. More than one 429 in a row means the\n  task needs the app credentials.\n\n## Verification\n\n`python3 scripts\u002Freddit.py doctor` prints `anonymous_feed: ok` and an\n`x-ratelimit-reset` value; `sub announcements --limit 1` returns one entry with a\n`reddit.com\u002Fr\u002Fannouncements\u002Fcomments\u002F` URL. With credentials set, `doctor` prints\n`active_backend: oauth` and `thread …` output shows numeric scores.\n","# Reddit Reading Skill\n\nReads Reddit content — subreddit listings, site or subreddit search, full threads with\ncomments, and user activity — from a server or headless machine where the normal routes\nare dead. It does not post, vote, or log in as a user. Idea credit: the per-platform\nbackend routing in [Agent Reach](https:\u002F\u002Fgithub.com\u002FPanniantong\u002FAgent-Reach).\n\n## When to Use\n\n- \"What is r\u002FLocalLLaMA saying about X\", \"find Reddit threads on Y\", \"summarise this\n  Reddit thread\", \"what has u\u002Fsomeone posted lately\".\n- Any `reddit.com` URL the user shares. `web_extract`, `browser_navigate` and the\n  `.json` endpoints all fail from server IPs (403 or a \"Prove your humanity\" wall);\n  this skill is the working path.\n- Not for posting, voting, messaging, or anything needing a user login.\n\n## Prerequisites\n\n**None.** No Reddit account, login, cookie, or API key is needed. The default backend is\nReddit's public Atom feeds (`.rss` endpoints), the only unauthenticated route Reddit still\nserves to non-residential IPs. It is throttled to about one request per minute per IP and\nreturns thinner data (no scores, top-level comments only), which is fine for a few calls.\n\n**Optional upgrade (app credentials, still no user login):** for sustained use or full\ndata, register a free \"script\" type app at https:\u002F\u002Fwww.reddit.com\u002Fprefs\u002Fapps and put its\ntwo values in `~\u002F.hermes\u002F.env`:\n\n```\nREDDIT_CLIENT_ID=...\nREDDIT_CLIENT_SECRET=...\n```\n\nThis is an application registration, not a login: the script uses the app-only\n`client_credentials` grant, never a username, password, or browser cookie, and never\nacts as the user. With both values set it switches to the OAuth API automatically\n(~100 requests per minute, scores, nested comments, `num_comments`); if they are\nmissing or rejected it falls back to the anonymous feeds and says so on stderr.\n\n| | Anonymous feeds (default) | OAuth app credentials |\n|---|---|---|\n| Setup | nothing | 1-minute app registration, two `.env` values |\n| Rate limit | ~1 request \u002F minute \u002F IP | ~100 requests \u002F minute |\n| Thread data | post + top-level comments, no scores | nested comments, scores, comment counts |\n| Acts as a user | no | no |\n\n## How to Run\n\nRun every command through `terminal` with the skill-relative script path:\n\n```bash\npython3 scripts\u002Freddit.py doctor                                  # which backend, current rate-limit window\npython3 scripts\u002Freddit.py sub LocalLLaMA --sort hot --limit 15\npython3 scripts\u002Freddit.py search \"hermes agent\" --sub LocalLLaMA --sort new\npython3 scripts\u002Freddit.py thread https:\u002F\u002Fwww.reddit.com\u002Fr\u002Fx\u002Fcomments\u002Fabc123\u002Fslug\u002F --limit 40\npython3 scripts\u002Freddit.py user spez --limit 10\npython3 scripts\u002Freddit.py --json search \"topic\"                  # machine-readable\n```\n\n## Quick Reference\n\nEvery command works on both backends; the script chooses the backend, you never pass a flag.\n\n| Need | Command | Anonymous | OAuth |\n|---|---|---|---|\n| Subreddit front page | `sub NAME --sort hot\\|new\\|top\\|rising [--time week]` | ✔ | ✔ |\n| Search all of Reddit | `search \"q\" --sort relevance\\|new\\|top\\|comments` | ✔ | ✔ |\n| Search one subreddit | `search \"q\" --sub NAME` | ✔ | ✔ |\n| Thread + comments | `thread URL --limit N` | ✔ top-level only, no scores | ✔ nested, scores |\n| User posts\u002Fcomments | `user NAME` | ✔ | ✔ |\n| Backend + rate limit | `doctor` | ✔ | ✔ |\n\n## Procedure\n\n① `doctor` once per task if you have not called it this session — it tells you which\nbackend is live and how many seconds remain in the anonymous window.\n\n② Plan your calls before making them. Anonymous Reddit allows roughly **one request per\nminute per IP**; the script sleeps until the window resets on a 429 and retries once, so\na five-call plan costs about five minutes. Prefer one `search --sub` over several `sub`\nlistings, and read one thread rather than the whole listing.\n\n③ For \"what is the community saying\" questions, read the thread bodies (`thread`) rather\nthan stopping at titles; the listing only carries the first ~300 characters of each post.\n\n④ Cite the permalink (`url` field), not the listing page, when the result feeds a report.\n`grounded-citations` registers these URLs like any other source.\n\n⑤ If the user needs sustained Reddit access (monitoring, more than ~10 calls), stop and\nask them to register the app credentials (Prerequisites) rather than grinding through the\nthrottle. Tell them plainly: it is a free app registration, not logging Hermes into their\naccount. Never ask for a Reddit password or browser cookies.\n\n## Pitfalls\n\n- `www.reddit.com\u002F…\u002F.json`, `api.reddit.com` and `old.reddit.com` return 403 or an\n  empty \"Welcome to Reddit\" shell for datacentre IPs. Do not fall back to them; do not\n  spoof a browser User-Agent (also 403).\n- `r.jina.ai` and the `browser_navigate` tool hit the same block (\"blocked by network\n  security\" \u002F humanity check). `blocked-page-recovery`'s Wayback route can still recover\n  an **old** thread that was archived; it cannot fetch fresh ones.\n- Anonymous thread feeds only contain the post plus top-level comments (Reddit caps the\n  feed at a handful of entries); scores and reply nesting are OAuth-only.\n- Reddit's `limit` on feeds is advisory — expect 5–25 entries regardless of what you ask.\n- Never paste `REDDIT_CLIENT_SECRET` into a chat or log; the script reads it from the\n  environment only.\n- Do not \"fix\" a 429 by retrying in a loop or adding a proxy; the throttle is per IP and\n  the script already waits out the window once. More than one 429 in a row means the\n  task needs the app credentials.\n\n## Verification\n\n`python3 scripts\u002Freddit.py doctor` prints `anonymous_feed: ok` and an\n`x-ratelimit-reset` value; `sub announcements --limit 1` returns one entry with a\n`reddit.com\u002Fr\u002Fannouncements\u002Fcomments\u002F` URL. With credentials set, `doctor` prints\n`active_backend: oauth` and `thread …` output shows numeric scores.\n",{"name":5,"author":23,"license":14,"version":24,"metadata":25,"platforms":38,"description":7},"Teknium (teknium1), Hermes Agent","1.0.0",{"hermes":26},{"tags":27,"related_skills":33},[28,29,30,31,32],"Reddit","Social Media","Research","Discussions","Community",[34,35,36,37],"rss-feeds","grounded-citations","blocked-page-recovery","xurl",[39,40,41],"linux","macos","windows","main","0905b0264ce5a54908bedc9637e50251543db132","optional-skills\u002Fsocial-media\u002Freddit-reading",0,"https:\u002F\u002Fgithub.com\u002Fashneil12\u002Fvanilla-hermes-agent-canary","https:\u002F\u002Fgithub.com\u002Fashneil12","2026-11-04 08:25:00",{"source":8,"skillName":5,"commands":50,"prompt":60,"zipAvailable":61},[51,54,57],{"tool":52,"command":53},"npx","npx skills add ashneil12\u002Fvanilla-hermes-agent-canary --skill reddit-reading",{"tool":55,"command":56},"bunx","bunx skills add ashneil12\u002Fvanilla-hermes-agent-canary --skill reddit-reading",{"tool":58,"command":59},"pnpm","pnpm dlx skills add ashneil12\u002Fvanilla-hermes-agent-canary --skill reddit-reading","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fashneil12\u002Fvanilla-hermes-agent-canary\u002Fblob\u002Fmain\u002Foptional-skills\u002Fsocial-media\u002Freddit-reading\u002FSKILL.md",true,[63],{"path":64,"resourceType":65,"resourceTypeDesc":66,"sizeBytes":67,"sourceHtmlUrl":68},"scripts\u002Freddit.py","SCRIPT","脚本",13927,"https:\u002F\u002Fgithub.com\u002Fashneil12\u002Fvanilla-hermes-agent-canary\u002Fblob\u002Fmain\u002Foptional-skills\u002Fsocial-media\u002Freddit-reading\u002Fscripts\u002Freddit.py",[70,76,83,90,97,104],{"skillNo":71,"name":36,"nameZh":6,"description":72,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":73,"categories":74,"keywords":75,"publishedAt":18},"01M7380YR13A23353XT9NS6EGR","Use when a fetch fails: 403\u002F429, paywall, WAF, bot wall.","https:\u002F\u002Fgithub.com\u002Fashneil12\u002Fvanilla-hermes-agent-canary\u002Fblob\u002Fmain\u002Fskills\u002Fweb\u002Fblocked-page-recovery\u002FSKILL.md",[],[],{"skillNo":77,"name":78,"nameZh":6,"description":79,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":80,"categories":81,"keywords":82,"publishedAt":18},"01M7380VZ8P60Q64J3F92D4AMY","test-driven-development","TDD: enforce RED-GREEN-REFACTOR, tests before code.","https:\u002F\u002Fgithub.com\u002Fashneil12\u002Fvanilla-hermes-agent-canary\u002Fblob\u002Fmain\u002Fskills\u002Fsoftware-development\u002Ftest-driven-development\u002FSKILL.md",[],[],{"skillNo":84,"name":85,"nameZh":6,"description":86,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":87,"categories":88,"keywords":89,"publishedAt":18},"01M7380QXN6F90R0MH1M3FHRKX","systematic-debugging","4-phase root cause debugging: understand bugs before fixing.","https:\u002F\u002Fgithub.com\u002Fashneil12\u002Fvanilla-hermes-agent-canary\u002Fblob\u002Fmain\u002Fskills\u002Fsoftware-development\u002Fsystematic-debugging\u002FSKILL.md",[],[],{"skillNo":91,"name":92,"nameZh":6,"description":93,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":94,"categories":95,"keywords":96,"publishedAt":18},"01M7380N4BZYT2WRRZN1N9DZ65","spike","Throwaway experiments to validate an idea before build.","https:\u002F\u002Fgithub.com\u002Fashneil12\u002Fvanilla-hermes-agent-canary\u002Fblob\u002Fmain\u002Fskills\u002Fsoftware-development\u002Fspike\u002FSKILL.md",[],[],{"skillNo":98,"name":99,"nameZh":6,"description":100,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":101,"categories":102,"keywords":103,"publishedAt":18},"01M7380JAEC9ZH5DVPHHK56P97","simplify-code","Parallel 4-agent cleanup of recent code changes.","https:\u002F\u002Fgithub.com\u002Fashneil12\u002Fvanilla-hermes-agent-canary\u002Fblob\u002Fmain\u002Fskills\u002Fsoftware-development\u002Fsimplify-code\u002FSKILL.md",[],[],{"skillNo":105,"name":106,"nameZh":6,"description":107,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":108,"categories":109,"keywords":110,"publishedAt":18},"01M7380F5MBB7FKWWV3G3TZ193","requesting-code-review","Pre-commit review: security scan, quality gates, auto-fix.","https:\u002F\u002Fgithub.com\u002Fashneil12\u002Fvanilla-hermes-agent-canary\u002Fblob\u002Fmain\u002Fskills\u002Fsoftware-development\u002Frequesting-code-review\u002FSKILL.md",[],[]]