Surprise Me
Analyze your reading history and tell you something surprising you don't know about yourself
Install
/plugin marketplace add readwiseio/readwise-skillsThe repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.
npx skills add readwiseio/readwise-skills --skill surprise-megit clone --depth 1 https://github.com/readwiseio/readwise-skills.git /tmp/readwise-skills
mkdir -p ~/.claude/skills
cp -r /tmp/readwise-skills/skills/surprise-me ~/.claude/skills/surprise-mePersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the 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"]`
Details
- Skill name
surprise-me- Repository
- readwiseio/readwise-skills
- Path
skills/surprise-me/SKILL.md- Repo updated
- 19 June 2026
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 the Surprise Me skill?
Claude Code plugin: /plugin marketplace add readwiseio/readwise-skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Surprise Me popular?
It lives in readwiseio/readwise-skills, which has 329 GitHub stars and 14 forks.
Related skills
Book Review
329readwiseio/readwise-skills
Draft a long-form book review from your Reader highlights — synthesizing the book with your broader reading history to generate original arguments
Build Persona
329readwiseio/readwise-skills
Build a personalized reading profile from your Readwise Reader data, used by triage, quiz, and other skills
Feed Catchup
329readwiseio/readwise-skills
Catch up on your RSS feed — highlights up top, full browse below
Table Manager
492cosmicstack-labs/mercury-agent-skills
Optimize table turns, manage reservations, and reduce wait times to maximize revenue per seat. Handles booking intake, table assignment strategy, waitlist management, and provides actionable insights for seating efficiency.
Staff Scheduler
492cosmicstack-labs/mercury-agent-skills
Build optimized staff schedules that match coverage to demand while respecting labor budgets, employee availability, and local labor laws. Handles shift swaps, time-off requests, and identifies over/under-staffing before it happens.
Triage
329readwiseio/readwise-skills
Triage Reader inbox one doc at a time with personalized pitches
Browse the most popular Claude skills, all other skills, or write your own with the skills generator.