# rss-skill

Adopt this skill: https://proskills.md/skills/other/atopos31-agent-rss-skill

Page: https://proskills.md/skills/other/atopos31-agent-rss-skill
This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required.

## File: skill/SKILL.md
size: 3188
upstream: https://github.com/atopos31/agent-rss/blob/main/skill/SKILL.md

````text
---
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 timezone
````

## File: README.md
upstream: https://github.com/atopos31/agent-rss/blob/main/README.md

````text
# agent-rss

[中文文档](./README_CN.md)

CLI RSS tool for AI agents. Subscribe to feeds, fetch RSS/Atom content, and filter by time or keywords.

## Installation

### npm

```bash
npm install -g @atopos31/agent-rss
```

### Go

```bash
go install github.com/atopos31/agent-rss/cmd/agent-rss@latest
```

### From Source

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

```bash
npx skills add atopos31/agent-rss
```

## Usage

### Subscription Management

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

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

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

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

```bash
# 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)

```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":"..."}
```

### JSON

```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](https://github.com/JackyST0/awesome-rsshub-routes) for a curated list of RSS feeds across various categories.

## License

MIT
````
