ReddRadar
Agent skill
readwise-chat
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".
Install this agent skill to your Project
npx add-skill https://github.com/edwinhu/workflows/tree/main/skills/readwise-chat
SKILL.md
Readwise Chat (RAG over Highlights)
Uses GPT-5.1 to answer questions with RAG over the user's full highlight library via WebSocket streaming.
Prerequisites
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.
Commands
One-Shot Query
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
Interactive REPL
Multi-turn conversation with context preserved:
readwise-custom chat-interactive
readwise-custom chat-interactive --model 5.1-thinking # reasoning model
Type exit to quit.
Conversation Management
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 Options
| Model ID | Name | Use Case |
|---|---|---|
5.1 |
Fast (default) | Quick answers, simple lookups |
5.1-thinking |
Thinking | Complex synthesis, reasoning |
Chat vs Search
| 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.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
edwinhu/workflows
audit-fix-loop
This skill should be used when the user asks to 'iteratively improve', 'audit and fix', 'hill-climb quality', 'grade and improve', 'score and fix', 'audit loop', 'quality loop', or needs structured iterative improvement of an artifact using scored independent audits. Also use when the user invokes a ralph loop for quality improvement rather than task completion.
edwinhu/workflows
ds-spec-reviewer
Internal skill used by ds-brainstorm at Phase 1 exit gate. Dispatches a reviewer subagent to verify SPEC.md completeness before planning. NOT user-facing.
edwinhu/workflows
pptx-render
Use when the user asks to "render pptx", "show pptx slide", "compare with pptx", "pptx to image", "export pptx slide", "original slide", "show me the original", "what does the pptx look like", or needs to extract a specific PPTX slide's content for visual comparison.
edwinhu/workflows
obsidian-organize
Organize Obsidian notes according to clawd's preferences. Use when user asks to "organize notes", "move notes to right folder", "clean up vault", "tidy vault", "file this note", or when creating new notes in the Obsidian vault. Also use when moving, renaming, or categorizing notes, or when the vault root has stray files.
edwinhu/workflows
dev-verify
This skill should be used when the user asks to 'verify completion', 'check that tests pass', 'confirm feature works', or REQUIRED Phase 7 of /dev workflow (final). Enforces fresh runtime evidence before claiming completion.
edwinhu/workflows
dev
This skill should be used when the user asks to 'start a feature', 'build a feature', 'implement a feature', 'develop', 'new feature', or needs the full 7-phase development workflow with TDD enforcement.
Didn't find tool you were looking for?