Skip to content

IvanCampos/agents / skills/opml-reader

opml-reader

Verified

Store OPML files and fetch latest posts across RSS/Atom feeds. Use when a user provides an OPML URL or file path, wants it saved under ~/Code/Files, or wants the newest entries aggregated across feeds (with optional JSON/TSV output, dedupe, and concurrency controls).

FileKindSize
SKILL.mdskill md1.8 KB
agents/openai.yamlconfig224 B
scripts/opml_reader.pyexecutablescript6.3 KB
---
name: opml-reader
description: Store OPML files and fetch latest posts across RSS/Atom feeds. Use when a user provides an OPML URL or file path, wants it saved under ~/Code/Files, or wants the newest entries aggregated across feeds (with optional JSON/TSV output, dedupe, and concurrency controls).
---

# OPML Reader

## Overview
Use `scripts/opml_reader.py` to (1) store OPML from a URL and (2) list the latest posts across all feeds in the OPML. Output timestamps are ISO-8601 in UTC.

## Quick Start
1. Create a venv and install dependency:

```bash
python3 -m venv ~/Code/sandbox/.venv-opml-reader
~/Code/sandbox/.venv-opml-reader/bin/pip install feedparser
```

2. Store an OPML file:

```bash
~/Code/sandbox/.venv-opml-reader/bin/python scripts/opml_reader.py store \
  "https://example.com/feeds.opml" \
  "~/Code/Files/feeds.opml"
```

3. Fetch latest posts:

```bash
~/Code/sandbox/.venv-opml-reader/bin/python scripts/opml_reader.py latest \
  "~/Code/Files/feeds.opml" \
  --limit 5
```

## Workflow
- If the user supplies an OPML URL, store it under `~/Code/Files` using `store`.
- If the OPML file already exists, reuse it unless the user explicitly asks to overwrite.
- Run `latest` to aggregate posts and return the newest entries across feeds.
- Report partial results if some feeds fail (network timeouts are expected on large lists).

## Output Options
- Default output: `text` lines formatted as `index. title | feed | date | link`.
- Use `--format json` or `--format tsv` if the user needs machine-readable output.
- Dedupe is on by default. Use `--no-dedupe` if the user wants raw results.
- Adjust `--workers` and `--timeout` for large or slow feed lists.

## Resources
### scripts/
- `scripts/opml_reader.py`: Store OPML files and list latest posts across RSS/Atom feeds.
receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementationStars: 322kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 322kUpdated Claude CodeCodexVerifiedInstall
using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallbackStars: 322kUpdated Claude CodeCodexVerifiedInstall
verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions alwaysStars: 322kUpdated Claude CodeCodexVerifiedInstall