Skip to content

IvanCampos/agents / skills/opml-reader

opml-reader

Unverified

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:
python3 -m venv ~/Code/sandbox/.venv-opml-reader
~/Code/sandbox/.venv-opml-reader/bin/pip install feedparser
  1. 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"
  1. 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.
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: 319kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 319kUpdated 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: 319kUpdated 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: 319kUpdated Claude CodeCodexVerifiedInstall