SKILL.md
RSS Agent Viewer
CLI RSS/Atom feed viewer with built-in discovery, caching, and search.
Quick start
npx -y rss-agent-viewer init
npx -y rss-agent-viewer discover https://vercel.com
npx -y rss-agent-viewer add https://vercel.com/atom
npx -y rss-agent-viewer readCore workflow
# Initialize config + database
rss-viewer initDiscover feeds for a site
rss-viewer discover https://example.com
Subscribe to a feed (optional: --timeout for slow feeds)
rss-viewer add https://example.com/feed.xml
rss-viewer add https://slow-site.com/feed.xml --timeout 30000
List feeds and read articles
rss-viewer feeds
rss-viewer read
## Common commands
rss-viewer init
rss-viewer add <url>
rss-viewer discover <url>
rss-viewer feeds
rss-viewer remove <url>
rss-viewer read [url]
rss-viewer search <query>
rss-viewer discover-search <query>
rss-viewer import <file>
rss-viewer export
rss-viewer cache <action>
rss-viewer cleanup
## Usage patterns
### Discover and subscribe
rss-viewer discover https://example.com
rss-viewer add https://example.com/rss.xml
### Read a single feed
rss-viewer read https://example.com/rss.xml
### Read all feeds (fetches fresh by default)
Fetches fresh articles from all feeds in parallel
rss-viewer read
Use cached data only (skip network requests)
rss-viewer read --cached
Limit results
rss-viewer read --limit 10
One latest article per feed (feed-diverse results)
rss-viewer read --latest-per-feed --limit 10
Timeouts (for slow feeds or many feeds)
rss-viewer read --timeout 15000 --overall-timeout 180000
### Clean up invalid feeds
Remove broken and duplicate feeds
rss-viewer cleanup
Preview what would be removed
rss-viewer cleanup --dry-run
Only remove broken feeds
rss-viewer cleanup --broken
Only remove duplicates
rss-viewer cleanup --duplicates
### Search across all feeds
Local database search (enhanced with full-text search)
rss-viewer search "open source"
Web search + discovery + add + search in one command
rss-viewer discover-search "Rust programming" --auto-add --read
Using Exa API (BYOK)
rss-viewer discover-search "AI safety" \
--provider exa \
--max-results 5 \
--auto-add \
--read
### Import OPML
rss-viewer import feeds.opml
### Export feeds
rss-viewer export
## Search Options
### Local Database Search
rss-viewer search "React 19" --limit 10
rss-viewer search "TypeScript" --author "Dan" --since "2024-01-01"
### Web Search with Discovery
Use agent's built-in search (default)
rss-viewer discover-search "micro-frontends" --auto-add --read
Use Exa API (requires EXA_API_KEY)
export EXA_API_KEY="your-api-key"
rss-viewer discover-search "WebGPU" \
--provider exa \
--max-results 5 \
--category Development \
--auto-add \
--read \
--limit 20
### Configuration
**Environment Variables:**
EXA_API_KEY="your-api-key" # Exa API key (optional)
RSS_FEED_TIMEOUT=10000 # Per-feed fetch timeout (ms)
RSS_VIEWER_SEARCH_PROVIDER="agent|exa" # Search provider (default: agent)
RSS_VIEWER_MAX_WEB_RESULTS=10 # Max web search results
RSS_VIEWER_SEARCH_LIMIT=20 # Max article results
RSS_VIEWER_BOOST_RECENT=false # Boost recent articles in search
EXA_API_URL="https://api.exa.ai/search" # Custom Exa endpoint (optional)
**Config File (~/.config/rss-viewer/config.json):**
{
"webSearchProvider": "exa",
"exaApiKey": "your-api-key",
"feedTimeout": 10000,
"overallTimeout": 120000,
"maxWebResults": 10,
"searchResultsLimit": 20,
"boostRecentSearch": false
}