Surprise Me

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

329 stars 14 forksOther Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add readwiseio/readwise-skills

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add readwiseio/readwise-skills --skill surprise-me
Manual install
git 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-me

Personal 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"]`
Read the full skill on GitHub

Details

Skill name
surprise-me
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

Browse the most popular Claude skills, all other skills, or write your own with the skills generator.