MCPInstall

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
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads surprise-me automatically when relevant.

  3. 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_highlights with limit=100
  • Highlight search 1: mcp__readwise__readwise_search_highlights with a broad term like "important" or "interesting"
  • Highlight search 2: mcp__readwise__readwise_search_highlights with another broad term like "surprised" or "changed my mind"
  • Tags: mcp__readwise__reader_list_tags
  • Archived documents: mcp__readwise__reader_list_documents with location="archive", limit=50, response_fields=["title", "author", "category", "tags", "word_count", "reading_progress", "saved_at", "last_opened_at"]
  • Shortlist documents: mcp__readwise__reader_list_documents with location="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

View all →

quiz

readwiseio/readwise-skills

Quiz yourself on documents you've recently read to test understanding and retention

Testing & QA609 installs

readwise-cli

readwiseio/readwise-skills

How to use the Readwise CLI — access highlights, documents, and your entire reading library from the command line

595 installs

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

507 installs

feed-catchup

readwiseio/readwise-skills

Catch up on your RSS feed — highlights up top, full browse below

501 installs

build-persona

readwiseio/readwise-skills

Build a personalized reading profile from your Readwise Reader data, used by triage, quiz, and other skills

492 installs

Popular other skills

View category →

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.

1.3M installs

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.

1M installs

ask-matt

mattpocock/skills

Ask which skill or flow fits your situation. A router over the skills in this repo.

778.4K installs

to-questionnaire

mattpocock/skills

Turn a decision you can't fully answer into a questionnaire for someone else to fill in.

508.9K installs

wait-what

mattpocock/skills

Stop. That last message did not land: re-pitch it.

459.7K installs

loop-me

mattpocock/skills

Grill me about specs for the workflows I want to build, within this workspace.

447.9K installs