Opml reader

Skill IvanCampos/agents/skills/opml-reader

All things related to my Codex agents running on MacOS

Install

npx -y skills add IvanCampos/agents --skill opml-reader

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

5 stars5 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

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).

SKILL.md

1.8 KB, as published. Nobody here has run it

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

Create a venv and install dependency:

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

Store an OPML file:

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

Fetch latest posts:

~/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.