readwiseio/readwise-skills/surprise-me

Claude Code and agent skill by readwiseio/readwise-skills

Trust tier 2
  • community
LLM review pending
Source check pending

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-me

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

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

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
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/readwiseio/readwise-skills/surprise-me/badge)](https://verified-skill.com/skills/readwiseio/readwise-skills/surprise-me)

Something wrong with this skill or its page? Tell us.