website/scripts/generate-skill-docs.py is the documented source of both catalogs and of the per-skill pages, but nothing compares its output with what is committed, so the committed copies drifted: - optional-skills-catalog.md was missing agent-merge-conflict-arbiter and listed pr-lens under blockchain (it lives in software-development); - skills-catalog.md still listed merge-reconciler, which #98539 moved out of the bundled set; - 196 pages and both catalogs carried Windows path separators — in the Path column and inside GitHub blob links, where a backslash is a broken URL. This commit is the generator's output (re-running it on this branch is a no-op), plus the orphan page #98539 left behind for merge-reconciler: no skill backs it, its catalog row is gone, and no page links to it. tests/skills/test_skill_docs_contract.py is the guard: the next skill that ships without a catalog row, or a page regenerated on Windows, fails there instead of on the published page.
5.4 KiB
| title | sidebar_label | description |
|---|---|---|
| Rss Feeds — Read RSS, Atom, JSON feeds; discover feeds behind a page | Rss Feeds | Read RSS, Atom, JSON feeds; discover feeds behind a page |
{/* This page is auto-generated from the skill's SKILL.md by website/scripts/generate-skill-docs.py. Edit the source SKILL.md, not this page. */}
Rss Feeds
Read RSS, Atom, JSON feeds; discover feeds behind a page.
Skill metadata
| Source | Optional — install with hermes skills install official/research/rss-feeds |
| Path | optional-skills/research/rss-feeds |
| Version | 1.0.0 |
| Author | Teknium (teknium1), Hermes Agent |
| License | MIT |
| Platforms | linux, macos, windows |
| Tags | RSS, Atom, Feeds, Monitoring, Research, Blogs, Releases |
| Related skills | reddit-reading, competitor-news-monitor, grounded-citations, youtube-content, blogwatcher |
Reference: full SKILL.md
:::info The following is the complete skill definition that Hermes loads when this skill is triggered. This is what the agent sees as instructions when the skill is active. :::
RSS Feeds Skill
Reads any RSS 2.0, RSS 1.0/RDF, Atom, or JSON Feed URL into a clean, date-sorted list of
entries, and discovers the feed behind an ordinary page URL (<link rel="alternate"> or
the usual /feed, /rss.xml, /atom.xml paths). Standard library only, nothing to
install. It does not fetch full article bodies — pass an entry's link to web_extract for
that.
When to Use
- "What's new on <blog/site>", "latest releases of <GitHub repo>", "recent posts in <subreddit>", "read this feed", "does this site have an RSS feed".
- Building a recurring digest with
cronjob_manage(feeds are cheaper and more stable than scraping the HTML front page every run). For a persistent read/unread database across many feeds install the optionalblogwatcherskill; this skill is the zero-install read. - Anything where a structured list of
title / link / date / author / summarybeats a rendered page: podcasts, changelogs, YouTube channels, newsrooms, forum categories.
Prerequisites
None. Python 3.10+, network access to the feed host.
How to Run
Run through terminal with the skill-relative script path:
python3 scripts/feed.py read https://hnrss.org/frontpage --limit 10
python3 scripts/feed.py read https://simonwillison.net/ # page URL → discovers the feed
python3 scripts/feed.py read URL --since 2026-09-01 --json # only newer entries, machine-readable
python3 scripts/feed.py discover https://example.com/ # list candidate feed URLs
Quick Reference
| Source | Feed URL pattern |
|---|---|
| GitHub releases / commits / tags | https://github.com/OWNER/REPO/releases.atom, …/commits/BRANCH.atom, …/tags.atom |
| Subreddit / Reddit search | https://www.reddit.com/r/NAME/.rss, https://www.reddit.com/search.rss?q=… (1 req/min anon; see reddit-reading) |
| YouTube channel | https://www.youtube.com/feeds/videos.xml?channel_id=UC… |
| Hacker News | https://hnrss.org/frontpage, https://hnrss.org/newest?q=TERM |
| arXiv category | https://rss.arxiv.org/rss/cs.CL |
| Substack / Medium / WordPress / Ghost | SITE/feed, medium.com/feed/@user, SITE/rss/ |
| Podcasts | the show's RSS URL from its hosting page (discover finds it) |
Output fields per entry: title, link, published (UTC ISO 8601), author, summary
(HTML stripped, ≤ 2000 chars). Entries are sorted newest-first.
Procedure
① If you only have a site URL, run read on it directly; the script discovers the feed
and reports which URL it used (discovered_from). Use discover when you want to choose
between several advertised feeds (comments feed vs posts feed, per-category feeds).
② Bound the request: --limit for "latest N", --since YYYY-MM-DD for "since last
check". For a cron digest persist the last-seen published value and pass it as
--since next run.
③ For full text, hand the entry link to web_extract; feed summaries are frequently
truncated or the first paragraph only.
④ Cite the entry link, not the feed URL, when the result feeds a report
(grounded-citations).
Pitfalls
- A 200 response with HTML means the URL is a page, not a feed; the script falls through
to discovery automatically, but a site with no
<link rel="alternate">and none of the common paths reportsno feed found— check the site's footer or/sitemap.xmlbefore concluding there is none. - Reddit feeds share Reddit's anonymous throttle (about one request per minute per IP).
Chain them through
reddit-reading, which waits out the window, when you need more than one Reddit call. - Dates: RSS
pubDateis RFC 822 and Atom uses ISO 8601; the script normalises both to UTC. Feeds that omit dates sort to the bottom and are dropped by--since. - Some feeds are Cloudflare-fronted and 403 non-browser clients;
blocked-page-recoveryhandles that class.
Verification
python3 scripts/feed.py read https://github.com/NousResearch/hermes-agent/releases.atom --limit 1 prints one entry with a releases/tag/ link and a [atom] format tag;
discover https://simonwillison.net/ prints an /atom/ URL.