⏳ 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
KEY FILES