Readwise Reader Skill

Use this skill to script workflows against the Readwise Reader product (saved articles, feeds, PDFs, newsletters).

Quick start

1. Generate a token from https://readwise.io/access_token and store it in READWISE_TOKEN.
2. Call uv run --project ${CLAUDE_PLUGIN_ROOT} python ${CLAUDE_PLUGIN_ROOT}/skills/readwise-reader/scripts/reader_client.py ... whenever possible; it handles retries, .generated tagging, and --dry-run against the /api/v3 endpoints.
3. Respect Reader's tighter rate limits (20 req/min). The CLI surfaces remaining budget whenever headers are present; throttle accordingly.

Example workflows

• "Save this article to Reader for later" — uses docs create with a URL
• "Show me what's new in my Reader inbox" — uses docs list --category new
• "Archive everything I've finished reading this week" — uses docs pull + docs update --state archive