readwiseio/readwise-skills

surprise-me

Analyze your reading history and tell you something surprising you don't know about yourself

First seen Mar 15, 2026

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

Browse all from 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.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Also listed on

Alternate registries and mirrors of this skill.

Repository health

Stars 306
Default branch master
Open issues 2
Status Active

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 3,556 B
  • docs SUMMARY.md 2,697 B

History

  1. First seen on skills.sh
  2. 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: mcpreadwisereadwiselisthighlights with limit=100
  • Highlight search 1: mcpreadwisereadwisesearchhighlights with a broad term like "important" or "interesting"
  • Highlight search 2: mcpreadwisereadwisesearchhighlights with another broad term like "surprised" or "changed my mind"
  • Tags: mcpreadwisereaderlisttags
  • Archived documents: mcpreadwisereaderlistdocuments with location="archive", limit=50, responsefields=["title", "author", "category", "tags", "wordcount", "readingprogress", "savedat", "lastopenedat"]
  • Shortlist documents: mcpreadwisereaderlistdocuments with location="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