Papr rss

Skill l0ng-ai/papr/skills/papr-rss

A fast, native RSS reader — plus an agent-facing CLI so your AI agent can read, search and triage your feeds from the shell.

Install

npx -y skills add l0ng-ai/papr --skill papr-rss

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

What its author says it does

Copied from the file, not written here

Read, search and triage the user's Papr RSS subscriptions from the shell via the `papr` CLI. Use when the user wants to catch up on their feeds, find or summarize articles they've subscribed to, check what's unread, star/save articles, subscribe to a new feed, or pull new posts. Triggers on: "what's in my feeds", "any unread RSS", "summarize this feed", "search my subscriptions for X", "mark these read", "subscribe to <url>", "refresh my feeds".

SKILL.md

4.2 KB, as published. Nobody here has run it

Papr RSS CLI

papr is a token-efficient, agent-facing CLI over the user's local Papr RSS database. It emits TOON on stdout (≈40% cheaper than JSON, via the official toon-format encoder), keeps diagnostics on stderr, and returns structured errors with exit codes (0 success/no-op, 1 runtime, 2 usage). Reads are token-minimal by default; long article bodies are truncated with a --full escape hatch.

Run papr with no arguments first — it prints the unread dashboard plus the most useful next commands, so you can orient without reading a manual.

Core flow

papr                        # home: unread/starred counts + recent unread + next steps
papr feeds                  # subscriptions grouped by folder, with unread counts
papr list --feed <id>       # articles in a feed (defaults to unread; --all for read too)
papr list --starred         # smart views: --starred / --later / --tag <id> / --folder <id>
papr list --fields author,url   # add columns: author,url,snippet,type,feed_id,published
papr read <id> [<id>...]    # plain-text body, truncated; pass several ids to batch
papr read --feed <id> --unread --limit 5   # read a feed's latest unread in one call
papr read <id> --full       # the complete body when truncation hid something
papr search "<query>"       # FTS5 full-text search across every article

Triage & subscriptions

papr mark read <id> [<id>...]      # state: read|unread|star|unstar|later|unlater (idempotent)
papr mark-all --feed <id>          # mark a whole view read
papr subscribe <url>               # auto-discovers the feed, inserts it, fetches it
papr refresh [--feed <id>]         # fetch new articles over the network (RSS + newsletters)
papr extract <id>                  # fetch & store the cleaned full text of an article

Management (mirrors the desktop app)

papr tags | papr tag add <tag_id> <article_id> | papr tag create "<name>"
papr folders | papr folder create "<name>" | papr feed move <id> --folder <id>
papr rules | papr rule create "<name>" "<keywords>" --action star
papr highlights [--article <id>] | papr highlight create <article_id> "<quote>"
papr newsletters | papr newsletter add --title .. --host .. --user .. --password ..
papr opml import <file> | papr opml export
papr settings get <key> | papr settings set <key> <value>
papr stats

Sync

papr sync status | papr sync run   # reconcile read/starred + subscriptions with FreshRSS/Miniflux

There are no summarize/ask/digest/translate commands: you are the language model, so read the text with papr read <id> (or gather candidates with papr search) and summarize, answer or translate it yourself — no second AI provider is involved.

Destructive verbs require --yes; without it they fail with exit 2 and tell you the exact command to re-run:

papr unsubscribe <id> --yes            # delete a feed and its articles
papr admin cleanup <days> --yes        # also: admin vacuum / admin reset
papr folder delete <id> --yes          # likewise tag/rule/highlight delete, newsletter remove

Notes

Every command takes --db <path> (or the PAPR_DB env var) if the database is not in the desktop app's default location.
Output is data, not prose. Each list states a definitive total (count: N of M unread) so you never need to paginate just to learn the size.
If the answer is "nothing", the command says so explicitly — a zero is an answer, not a reason to retry with different flags.
Prefer the ambient SessionStart hook (papr setup) so the unread dashboard is already in context at the start of a conversation; this skill is the lower-overhead alternative that loads only when a feed task comes up.