rss-feed-discovery - SKILL.md Agent Skill

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.