⏳ This skill is pending AI review.
Scores will appear once the review pipeline completes.
rss-skill
Use this skill when the user wants to fetch, read, or monitor RSS/Atom feeds. This includes subscribing to RSS sources, fetching latest news/articles from feeds, filtering feed items by time (past hours/days) or keywords, and managing feed subscriptions. Use this skill when the user mentions RSS, feeds, news subscriptions, or wants to stay updated on websites/blogs.
Choose how to use this skill
You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.
1. Native installer
This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.
Do not guess an installer command or replace an existing version without reviewing the diff.
2. Complete package recommended
Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.
No complete ProSkills package is published for this listing yet.3. Prompt-only
Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.
Need only the instruction file?
Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.
No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.
// RATINGS
// README
agent-rss
CLI RSS tool for AI agents. Subscribe to feeds, fetch RSS/Atom content, and filter by time or keywords.
Installation
npm
npm install -g @atopos31/agent-rss
Go
go install github.com/atopos31/agent-rss/cmd/agent-rss@latest
From Source
git clone https://github.com/atopos31/agent-rss.git
cd agent-rss
go build -o agent-rss ./cmd/agent-rss
As a Skill
Install as a skill for AI agents that support skills:
npx skills add atopos31/agent-rss
Usage
Subscription Management
# Add a feed
agent-rss add hn https://news.ycombinator.com/rss
# List all feeds
agent-rss list
# Get a specific feed
agent-rss get hn
# Update a feed
agent-rss update hn --src https://news.ycombinator.com/rss
# Remove a feed
agent-rss remove hn
Fetching RSS
# Fetch a specific feed
agent-rss fetch --name hn
# Fetch all feeds
agent-rss fetch --all
# Output as JSON array (default is NDJSON)
agent-rss fetch --all --format json
Filtering
# Filter by relative time (past hours/days/minutes)
agent-rss fetch --all --since 1h # past 1 hour
agent-rss fetch --all --since 2d # past 2 days
agent-rss fetch --all --since 30m # past 30 minutes
# Filter by absolute time
agent-rss fetch --all --since 2026-03-12
agent-rss fetch --all --since 2026-03-12T08:00:00+08:00 --until 2026-03-12T18:00:00+08:00
# Filter by title keyword
agent-rss fetch --all --title "AI"
# Filter by content keyword
agent-rss fetch --all --content "machine learning"
# Combine filters
agent-rss fetch --all --since 1d --title "Go" --title "Rust"
Global Options
# Use a custom feeds file
agent-rss --file /path/to/feeds.txt list
Best Practices for AI Agents
Many AI agent environments (like Claude Code, OpenClaw, etc.) have output size limits for bash commands. When fetching RSS feeds with lots of content, the output may be truncated.
Recommended approach: Write output to a file, then use the agent's file reading capability to access the full content.
# Write RSS output to a temporary file
agent-rss fetch --all --since 2026-03-12 > /tmp/rss-output.json
# Then use the agent's Read tool to access the complete content
# The agent can read /tmp/rss-output.json without size limitations
This pattern ensures:
- No truncation of RSS content
- Full access to all fetched items
- Better handling of large feeds
Feeds File Format
Feeds are stored in ~/.config/agent-rss/feeds.txt:
# Comments start with #
hn https://news.ycombinator.com/rss
golang https://blog.golang.org/feed.atom
Output Format
NDJSON (default)
{"name":"hn","src":"https://...","time":"2026-03-12T15:30:00+08:00","title":"...","content":"...","link":"...","id":"..."}
{"name":"hn","src":"https://...","time":"2026-03-12T14:20:00+08:00","title":"...","content":"...","link":"...","id":"..."}
JSON
[
{"name":"hn","src":"https://...","time":"2026-03-12T15:30:00+08:00","title":"...","content":"...","link":"...","id":"..."},
{"name":"hn","src":"https://...","time":"2026-03-12T14:20:00+08:00","title":"...","content":"...","link":"...","id":"..."}
]
Find RSS Feeds
Looking for RSS feeds to subscribe? Check out awesome-rsshub-routes for a curated list of RSS feeds across various categories.
License
MIT
// HOW IT'S BUILT
// FILES
2 files shipped with this skill. Inline text is the catalog copy. The upstream link is the source repository.
skill/SKILL.md3.1 KBupstream ↗
--- name: rss-skill description: Use this skill when the user wants to fetch, read, or monitor RSS/Atom feeds. This includes subscribing to RSS sources, fetching latest news/articles from feeds, filtering feed items by time (past hours/days) or keywords, and managing feed subscriptions. Use this skill when the user mentions RSS, feeds, news subscriptions, or wants to stay updated on websites/blogs. --- # RSS Feed Management with agent-rss ## Overview agent-rss is a CLI tool for fetching and filtering RSS/Atom feeds. It outputs structured JSON for easy processing. ## Installation Check First, check if agent-rss is installed: ```bash which agent-rss || echo "not installed" ``` If not installed: ```bash npm install -g @atopos31/agent-rss ``` ## Core Commands ### Managing Subscriptions ```bash # Add a feed agent-rss add <name> <url> # List all feeds agent-rss list # Get a specific feed agent-rss get <name> # Update a feed agent-rss update <name> --src <new-url> # Remove a feed agent-rss remove <name> ``` ### Fetching RSS ```bash # Fetch specific feed agent-rss fetch --name <name> # Fetch all feeds agent-rss fetch --all # Output as JSON array (default is NDJSON) agent-rss fetch --all --format json ``` ### Time Filtering ```bash # Relative time (recommended for agents) agent-rss fetch --all --since 1h # past 1 hour agent-rss fetch --all --since 2d # past 2 days agent-rss fetch --all --since 30m # past 30 minutes # Absolute time agent-rss fetch --all --since 2026-03-12 agent-rss fetch --all --since 2026-03-12T08:00:00+08:00 ``` ### Keyword Filtering ```bash # Filter by title agent-rss fetch --all --title "AI" --title "ML" # Filter by content agent-rss fetch --all --content "machine learning" # Combine filters agent-rss fetch --all --since 1d --title "AI" ``` ## Best Practice: Output to File **IMPORTANT**: CLI output may be truncated due to size limits. Always write output to a file, then read it: ```bash # Step 1: Write to file agent-rss fetch --all --since 1d > /tmp/rss-output.json # Step 2: Use Read tool to access full content # Read /tmp/rss-output.json ``` This ensures no data is lost due to output truncation. ## Output Format Each item contains: ```json { "name": "feed-name", "src": "https://example.com/rss", "time": "2026-03-12T15:30:00+08:00", "title": "Article Title", "content": "Article content or summary", "link": "https://example.com/article", "id": "unique-id" } ``` ## Common Workflows ### Check for Recent News ```bash agent-rss fetch --all --since 1h > /tmp/recent.json # Then read /tmp/recent.json ``` ### Search for Specific Topics ```bash agent-rss fetch --all --since 1d --title "AI" --title "LLM" > /tmp/ai-news.json # Then read /tmp/ai-news.json ``` ### Daily News Summary ```bash agent-rss fetch --all --since 24h --format json > /tmp/daily.json # Then read /tmp/daily.json and summarize ``` ## Finding RSS Feeds For curated RSS feeds, see: https://github.com/JackyST0/awesome-rsshub-routes ## Troubleshooting - If a feed times out, try fetching it individually with `--name` - Use `--format json` for JSON array output - Times are displayed in local timezoneREADME.mdupstream ↗
Contents are not inlined in the catalog. Open the upstream file.
Plain-text copy, no login: /skill-bundles/atopos31-agent-rss-skill.md