
surprise-me
Analyze your reading history and tell you something surprising you don't know about yourself
- Installs
- 445
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/readwiseio/readwise-skills --skill surprise-me- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads surprise-me automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
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
FAQ
What does the surprise-me skill do?
Analyze your reading history and tell you something surprising you don't know about yourself
How do I install surprise-me?
Run npx skills add https://github.com/readwiseio/readwise-skills --skill surprise-me in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/surprise-me/ (personal) or .claude/skills/surprise-me/ (project).
Which AI agents can use surprise-me?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is surprise-me safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains surprise-me?
It is published by readwiseio in readwiseio/readwise-skills. It has 445 recorded installs.
More from readwiseio/readwise-skills
quiz
readwiseio/readwise-skills
Quiz yourself on documents you've recently read to test understanding and retention
readwise-cli
readwiseio/readwise-skills
How to use the Readwise CLI — access highlights, documents, and your entire reading library from the command line
book-review
readwiseio/readwise-skills
Draft a long-form book review from your Reader highlights — synthesizing the book with your broader reading history to generate original arguments
reader-recap
readwiseio/readwise-skills
Conversational briefing on your recent reading — what you finished, what you highlighted, and what you had to say about it
feed-catchup
readwiseio/readwise-skills
Catch up on your RSS feed — highlights up top, full browse below
build-persona
readwiseio/readwise-skills
Build a personalized reading profile from your Readwise Reader data, used by triage, quiz, and other skills
Popular other skills
hyperframes-cli
heygen-com/hyperframes
The HyperFrames CLI by job - scaffold, check, look at frames, edit the timeline, preview, render locally or in the cloud, publish, project history - plus reading its JSON and recovering from build or render failures.
triage
mattpocock/skills
Move issues and external PRs through a state machine of triage roles, categorise, verify, grill if needed, and write agent-ready briefs.
ask-matt
mattpocock/skills
Ask which skill or flow fits your situation. A router over the skills in this repo.
to-questionnaire
mattpocock/skills
Turn a decision you can't fully answer into a questionnaire for someone else to fill in.
loop-me
mattpocock/skills
Grill me about specs for the workflows I want to build, within this workspace.