surprise-me

Installation
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"]
Related skills
Installs
280
GitHub Stars
221
First Seen
Mar 15, 2026