npx skills add https://github.com/bytedance/deer-flow
readwiseio/readwise-skills
surprise-me
Analyze your reading history and tell you something surprising you don't know about yourself
Installation
npx skills add readwiseio/readwise-skills --skill surprise-me
Similar popular skills
Related neighbors and high-traction skills in the same topics — useful to compare before installing.
Also in this package
Other skills from readwiseio/readwise-skills · top by installs.
npx skills add readwiseio/readwise-skills
More details
Agent compatibility
Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.
Also listed on
Alternate registries and mirrors of this skill.
npx skills add smithery/devman57 --skill surprise-me
Repository health
master
Package contents
Files included with this skill beyond the listing page.
-
skill md
SKILL.md3,556 B -
docs
SUMMARY.md2,697 B
History
- First seen on skills.sh
- First recorded snapshot · 426 installs
SKILL.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. mcpreadwisereaderlistdocuments). 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:
mcpreadwisereadwiselisthighlightswithlimit=100 - Highlight search 1:
mcpreadwisereadwisesearchhighlightswith a broad term like "important" or "interesting" - Highlight search 2:
mcpreadwisereadwisesearchhighlightswith another broad term like "surprised" or "changed my mind" - Tags:
mcpreadwisereaderlisttags - Archived documents:
mcpreadwisereaderlistdocumentswithlocation="archive",limit=50,responsefields=["title", "author", "category", "tags", "wordcount", "readingprogress", "savedat", "lastopenedat"] - Shortlist documents:
mcpreadwisereaderlistdocumentswithlocation="shortlist",limit=50,responsefields=["title", "author", "category", "tags", "wordcount", "readingprogress", "savedat"]
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