---
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:

```bash
subscription-research rss discover \
  --url https://example.com/blog \
  --validate
```

Discover feeds from a Markdown or text URL list:

```bash
subscription-research rss discover \
  --input candidate-pages.md \
  --validate > discovered-feeds.json
```

Dry-run a reviewed discovery patch against an existing registry:

```bash
subscription-research rss apply-source-patch \
  --registry feeds.json \
  --patch discovered-feeds.json \
  --format markdown
```

Apply a reviewed patch to a new registry output:

```bash
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.