skills/readwise-chat/SKILL.md
Chat with Readwise highlights using GPT-5.1 RAG. Use when the user wants to ask questions about their reading library, get summaries across documents, or have a conversation about their highlights. Triggers on "ask readwise", "chat about my highlights", "what do my notes say about", "summarize my reading on".
npx skillsauth add edwinhu/workflows readwise-chatInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Uses GPT-5.1 to answer questions with RAG over the user's full highlight library via WebSocket streaming.
Chat requires session cookies (not API token). Check if configured:
grep SESSION_COOKIES ~/.readwise/env
If missing, run:
readwise-custom auth session
This launches Chrome, navigates to readwise.io/chat, and extracts httpOnly session cookies via CDP.
Streams the response to stdout as it arrives:
readwise-custom chat "What are my highlights about fiduciary duty?"
readwise-custom chat "Summarize my notes on proxy advisors"
readwise-custom chat "Compare what I've read about SEC regulation vs FINRA"
With JSON output (includes related highlights):
readwise-custom chat "What do my highlights say about broker-dealer regulation?" --json
Multi-turn conversation with context preserved:
readwise-custom chat-interactive
readwise-custom chat-interactive --model 5.1-thinking # reasoning model
Type exit to quit.
readwise-custom chat-list # List all conversations
readwise-custom chat-get <id> # Get conversation with messages
readwise-custom chat-delete <id> # Delete conversation
readwise-custom chat-rename <id> "Better Title" # Rename conversation
| Model ID | Name | Use Case |
|----------|------|----------|
| 5.1 | Fast (default) | Quick answers, simple lookups |
| 5.1-thinking | Thinking | Complex synthesis, reasoning |
| Feature | readwise-custom chat | readwise readwise-search-highlights |
|---------|-----------------|-------------------|
| Returns | Synthesized answer + highlights | Raw highlight matches |
| Model | GPT-5.1 RAG | Vector similarity |
| Auth | Session cookies | API token |
| Speed | ~3-10s (streaming) | ~2s |
| Highlights returned | Up to 69 | Top-N vector matches |
| Multi-turn | Yes (interactive) | No |
Use chat when: You want a synthesized answer, cross-document analysis, or conversational exploration.
Use search when: You want raw highlight matches, exact quotes, or structured data for further processing.
tools
Use when "query Dewey Data", "deweydata.io", "SafeGraph places/patterns/spend", "Advan foot traffic", "POI / points of interest", "mobility data", "dataplor", "Veraset", "PassBy", "crypto/Bitcoin ATM locations", or any pull from the Dewey Data academic marketplace (UVA/NYU Platform Subscription) via the deweypy/deweydatapy client, DuckDB, or the Dewey MCP server.
development
Use when submitting jobs to UVA HPC (Rivanna/Afton), writing Slurm scripts (sbatch/srun/squeue), converting SGE to Slurm, running compute on any Slurm-managed cluster, or building WRDS data pipelines with polars on HPC. Triggers: 'submit to HPC', 'sbatch', 'squeue', 'slurm job', 'run on Rivanna', 'run on Afton', 'HPC array job', 'convert SGE to Slurm', 'polars on HPC', 'WRDS from HPC'.
testing
Internal skill for literature review and source materialization. Called after brainstorm, before setup. NOT user-facing.
development
This skill should be used when the user asks to "add paper", "paperpile add", "fetch PDF for", "find and add", "search paperpile", "find in paperpile", "paperpile search", "label paper", "trash paper", "download paper", "paperpile index", "edit paper metadata", "update paper title", "fix paper author", "paperpile edit", "find PDF online", "search google for PDF", "resolve PDF", "fetch PDF for citation", "get full-text for DOI", "resolve cite to PDF", or any request to manage their Paperpile library or resolve a citation to a local PDF.