Readwise Original Skill

Use this skill to automate work with the Readwise "Original" API that powers highlight exports and metadata management.

Quick start

1. Generate a token from https://readwise.io/access_token and store it in READWISE_TOKEN.
2. Use uv run --project ${CLAUDE_PLUGIN_ROOT} python ${CLAUDE_PLUGIN_ROOT}/skills/readwise/scripts/readwise_client.py ... instead of calling the API directly; it handles retries, pagination, rate-limit surfacing, --dry-run, and tagging rules.
3. Keep requests below the documented rate limit (currently 60 req/min). Batch operations and pause between pages when processing large libraries.

Example workflows

• "Summarize my daily review and save highlights to a note" — uses highlights review to fetch today's highlights, then formats them
• "Find all highlights from Meditations and export as markdown" — uses books to find the book ID, then highlights list to fetch
• "Save this quote to my Readwise" — uses highlight create with the quote text

CLI commands

Global options --dry-run and --raw can appear anywhere in the command.