| name | rss-feed-discovery |
| description | Use when an agent needs to discover RSS or Atom feed URLs from public pages, validate candidate feeds, or generate reviewable feed registry patches before source curation. |
RSS Feed Discovery
Overview
Use this skill to find candidate RSS or Atom feeds from public web pages or URL lists. Keep discovery separate from daily digests and source governance: this skill proposes feed additions, rss-source-curator reviews source quality, and rss-ai-digest produces ordinary digests.
Workflow Selection
- For discovering candidate RSS/Atom feed URLs from pages, use this skill.
- For reviewing feed quality, failures, scoring, or registry maintenance, use
rss-source-curator.
- For producing daily reports or monitoring new entries, use
rss-ai-digest.
- For deep research synthesis from archived evidence, use
subscription-research-agent.
Runtime Command
Examples use subscription-research as a compatibility command. Before running commands, resolve the runtime command:
- Use
DIGESTPILOT_RUNTIME_CMD when the environment provides a custom runtime command.
- Use
digestpilot-runtime when it is available on PATH.
- Use
subscription-research when only the legacy compatibility command is available on PATH.
- From a repository checkout without a linked command, replace
subscription-research with node packages/research-cli/dist/src/cli.js.
- Run
node scripts/doctor.mjs from the repository root to diagnose local runtime setup.
- If no runtime command is available but this repository or plugin package includes runtime source, run
node scripts/bootstrap-runtime.mjs, then retry the command.
Core Commands
Discover feeds from one page:
subscription-research rss discover \
--url https://example.com/blog \
--validate
Discover feeds from a Markdown or text URL list:
subscription-research rss discover \
--input candidate-pages.md \
--validate > discovered-feeds.json
Dry-run a reviewed discovery patch against an existing registry:
subscription-research rss apply-source-patch \
--registry feeds.json \
--patch discovered-feeds.json \
--format markdown
Apply a reviewed patch to a new registry output:
subscription-research rss apply-source-patch \
--registry feeds.json \
--patch discovered-feeds.json \
--output feeds.discovered.json \
--apply
Output Guidance
Discovery output is a candidate list and registry patch envelope. Do not treat discovered feeds as trusted sources until they are reviewed or curated.
When summarizing results for a user, include:
- page URL inspected
- feed URL discovered
- feed type when available
- validation status when
--validate was used
- proposed registry patch path or next review action
Boundaries
Do not automatically add discovered feeds to the user's primary registry. Generate reviewable patches first, then apply only to an explicit output file after review.
