readwiseio/readwise-skills/surprise-me
Claude Code and agent skill by readwiseio/readwise-skills
- community
Checking that the SKILL.md file is still in the repository.
Analyze your reading history and tell you something surprising you don't know about yourself
Install
npx vskill@latest install readwiseio/readwise-skills/surprise-meSKILL.md
You are analyzing the user's reading data from Readwise and Reader to surface a surprising insight about them as a reader and thinker. Follow this process carefully.
Readwise Access
Check if Readwise MCP tools are available (e.g. mcp__readwise__reader_list_documents). If they are, use them throughout. If not, use the equivalent readwise CLI commands instead (e.g. readwise list, readwise read <id>, readwise search <query>). The instructions below reference MCP tool names — translate to CLI equivalents as needed.
Process
1. Gather Data
Cast a wide net. Run ALL of these in parallel:
- Recent highlights:
mcp__readwise__readwise_list_highlightswithlimit=100 - Highlight search 1:
mcp__readwise__readwise_search_highlightswith a broad term like "important" or "interesting" - Highlight search 2:
mcp__readwise__readwise_search_highlightswith another broad term like "surprised" or "changed my mind" - Tags:
mcp__readwise__reader_list_tags - Archived documents:
mcp__readwise__reader_list_documentswithlocation="archive",limit=50,response_fields=["title", "author", "category", "tags", "word_count", "reading_progress", "saved_at", "last_opened_at"] - Shortlist documents:
mcp__readwise__reader_list_documentswithlocation="shortlist",limit=50,response_fields=["title", "author", "category", "tags", "word_count", "reading_progress", "saved_at"]
Then paginate the archive at least 2-3 more pages to get a larger sample.
2. Analyze
Look across ALL the data for patterns, contradictions, and surprises. Consider:
- Hidden obsessions: Topics that show up way more than expected across highlights and saves
- Contradictions: Are they saving/highlighting opposing viewpoints? Do their reading interests conflict with each other in interesting ways?
- Reading behavior patterns: Do they save more than they read? Highlight differently across categories? Binge certain authors?
- Evolving interests: Has their reading shifted over time? What are they moving toward or away from?
- Blind spots: What's conspicuously absent given their other interests?
- Unexpected connections: Do two seemingly unrelated interests actually share a deeper thread?
- What they highlight vs what they save: Do the highlights reveal different interests than the documents they save?
3. Deliver the Surprise
Present ONE genuinely surprising insight. Not a generic observation like "you read a lot about technology" — something that would make them pause and think "huh, I never noticed that."
Format:
Here's something you might not know about yourself:[The surprising insight — 2-3 sentences, specific and grounded in their actual data]
Then back it up with evidence:
- Quote specific highlights that support the insight
- Reference specific documents/authors
- Show the pattern across multiple data points
4. Go Deeper
After delivering the insight, offer:
- "Want me to dig into this further?"
- "I noticed a few other patterns too — want to hear them?"
- "Want me to find documents in your library that connect to this theme?"
Tone
- Genuinely curious and observant, like a perceptive friend who noticed something you didn't
- Specific — always reference real data, never generic platitudes
- Surprising — if the insight feels obvious, dig deeper until you find something that isn't
Security
- Security scanPassed, 100 of 100Pattern checks on the skill's files.
- Model reviewNot runA model review is scheduled for the next rescan.
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/surprise-me/SKILL.md
Popularity
- Repository stars
- 324
- Repository forks
- 13
- 7-day trend score
- 0
Stars and forks are for the whole GitHub repository, not this skill alone. Refreshed 17 Mar 2026, 7 months ago.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/readwiseio/readwise-skills/surprise-me)