Readwise agent skills for Claude Code, Cursor and RevampKey

4 ready-made playbooks that teach an AI agent how to do real Readwise work: which tools to call, what to check first, and when to stop and ask you.

Download RevampKey, free I have it: connect Readwise

Connect Readwise once and all 4 skills install themselves and stay up to date. Mac, Windows and Linux.

All 4 Readwise skills

Each skill is one job. You ask in plain words and the agent loads the skill that matches, then follows its steps.

Start hereAsks before writing21 Readwise tools

Use Readwise with AI

Teaches an AI assistant how to pick the right Readwise product, keep searches small, and ask before changing any highlight, document, tag or reading record.

Use it when

You want to search your highlights and Reader library without the assistant mixing up products.
You want the assistant to browse your inbox without moving or tagging anything by accident.
You want reading data answered from the right source and changes shown before they are made.

Tools it uses

readwise_search_highlights
reader_search_documents
readwise_list_highlights
reader_list_documents
reader_get_document_details
reader_get_document_highlights
readwise_get_daily_review
reader_export_documents
reader_get_export_documents_status
readwise_create_highlights
readwise_update_highlight
readwise_delete_highlight
reader_create_highlight
reader_set_highlight_notes
reader_add_tags_to_highlight
reader_remove_tags_from_highlight
reader_create_document
reader_move_documents
reader_bulk_edit_document_metadata
reader_add_tags_to_document
reader_remove_tags_from_document

Example

Search my Readwise highlights and Reader documents for anything about habit formation, and show me where each result came from.

I searched your Readwise highlights and Reader library for "habit formation" and found 12 matches: 7 highlights from books and 5 Reader documents. The 5 documents are in your later location. I have not changed anything. Want me to tag those five with a habits tag?

Use in RevampKeyRead the full skill →

Asks before writing9 Readwise tools

Quiz yourself on your Readwise highlights

Pulls highlights from your Readwise and Reader library, turns them into recall questions, and grades your answers against the original text. It only reads your data and asks before changing any highlight or note.

Use it when

You want to test whether you remember what you highlighted last month.
You are doing your daily review and want the highlights due today.
You finished a book and want to check which of its key ideas stuck.

Tools it uses

readwise_get_daily_review
readwise_search_highlights
readwise_list_highlights
reader_search_documents
reader_get_document_highlights
reader_get_document_details
reader_set_highlight_notes
reader_add_tags_to_highlight
readwise_update_highlight

Example

Quiz me on five of my highlights about habit formation and grade my answers.

I found 14 highlights on habit formation across your Readwise and Reader library and picked five. Question 1 is from Atomic Habits: describe the two-minute rule in your own words. You answered that it means starting small, which is partly right. Your answer missed that the goal is making the habit easy to begin, so I have quoted the passage for you to see.

Use in RevampKeyRead the full skill →

Read-only6 Readwise tools

Digest your Readwise library with AI

Summarises what you saved to Reader or highlighted over a period, clusters items by theme and points out what stands out. It only reads your library and changes nothing.

Use it when

You want a weekly roundup of what you saved to Reader
You want to see which themes your highlights keep returning to
You want to know which saved articles you collected but never read

Tools it uses

reader_list_documents
readwise_list_highlights
reader_list_tags
reader_get_document_details
reader_search_documents
readwise_search_highlights

Example

Give me a digest of everything I saved to Reader last week. Group it by theme, link the items, and tell me what stands out.

Last week you saved 24 items. They fall into four themes: decision-making under uncertainty (9 items, 6 highlighted), remote team habits (6 items, 2 highlighted), sleep research (5 items, 0 highlighted) and one miscellaneous group (4 items). The decision-making cluster has the most engagement, led by a long essay with 31 highlights. The five sleep articles were saved but never opened, so they look like a backlog rather than reading. I did not change anything in your inbox.

Use in RevampKeyRead the full skill →

Asks before writing8 Readwise tools

Triage your Reader inbox

Goes through your newest Reader inbox items, decides which to read now, read later or archive, and proposes tags. It asks before moving or tagging anything.

Use it when

You have a backlog of saved articles and want to know what to read first
You want to clear your inbox without reading every item
You need suggested tags for newly saved items

Tools it uses

reader_list_documents
reader_get_document_details
reader_list_tags
readwise_search_highlights
reader_move_documents
reader_bulk_edit_document_metadata
reader_add_tags_to_document
reader_remove_tags_from_document

Example

Triage my Reader inbox. Show the 10 newest items in a table and tell me which to read now, which later, and which to archive.

Triaged 10 newest inbox items (6 remain). Read now: 3 items, including a Stripe engineering post that matches your recent highlights on payments. Later: 4 long essays you have no time for this week. Archive: 3 items, including a conference announcement whose event has passed. Nothing has changed yet. Reply yes to apply, or list the numbers to change.

Use in RevampKeyRead the full skill →

Get all 4 without copying a file

RevampKey adds the skills when you connect Readwise, updates them for you and removes them when you disconnect.

Download RevampKey

How Readwise skills work

Connect Readwise
The Readwise MCP server gives the agent its tools.
Ask in plain words
“Quiz me on five of my highlights about habit formation and grade my answers.” Each SKILL.md says when it applies, so only the one that fits is loaded.
Approve any change
The agent calls the tools in order, checks its work, and shows you any change before it makes it.

How to install Readwise skills

In RevampKey the skills install themselves when you connect Readwise. In other tools each skill is one folder with a SKILL.md file, and you also need the Readwise MCP server connected there.

About 1 minute · nothing to copy

Download RevampKey for Mac, Windows or Linux and sign in.
Open Connectors and connect Readwise. All 4 skills come with it and stay up to date; they go away when you remove the connector.
Ask in plain language, for example “Quiz me on five of my highlights about habit formation and grade my answers.”
Download RevampKeyConnect Readwise · 1 click
Get RevampKey to connect Readwise
RevampKey is a free desktop app for Mac, Windows and Linux. Install it, sign in, and Readwise is one click away with its skills already attached.
Download RevampKey
Not now? Use the skills in your current tool
for s in essentials highlight-review-and-recall library-digest reader-inbox-triage; do curl -fsSL --create-dirs -o .claude/skills/readwise-$s/SKILL.md https://revampkey.com/marketplace/readwise/skills/$s/SKILL.md done
Other tools

Into this project’s .claude/skills folder

Connect the Readwise MCP server in Claude Code.

Run this in your project folder to add all 4 skills:

for s in essentials highlight-review-and-recall library-digest reader-inbox-triage; do
  curl -fsSL --create-dirs -o .claude/skills/readwise-$s/SKILL.md https://revampkey.com/marketplace/readwise/skills/$s/SKILL.md
done

Ask in plain language, for example “Quiz me on five of my highlights about habit formation and grade my answers.”

Into the shared .agents/skills folder

Connect the Readwise MCP server in Cursor.

Run this in your project folder to add all 4 skills:

for s in essentials highlight-review-and-recall library-digest reader-inbox-triage; do
  curl -fsSL --create-dirs -o .agents/skills/readwise-$s/SKILL.md https://revampkey.com/marketplace/readwise/skills/$s/SKILL.md
done

Ask in plain language, for example “Quiz me on five of my highlights about habit formation and grade my answers.”

Into the shared .agents/skills folder

Connect the Readwise MCP server in Codex.

Run this in your project folder to add all 4 skills:

for s in essentials highlight-review-and-recall library-digest reader-inbox-triage; do
  curl -fsSL --create-dirs -o .agents/skills/readwise-$s/SKILL.md https://revampkey.com/marketplace/readwise/skills/$s/SKILL.md
done

Ask in plain language, for example “Quiz me on five of my highlights about habit formation and grade my answers.”

Into the shared .agents/skills folder

Connect the Readwise MCP server in VS Code.

Run this in your project folder to add all 4 skills:

for s in essentials highlight-review-and-recall library-digest reader-inbox-triage; do
  curl -fsSL --create-dirs -o .agents/skills/readwise-$s/SKILL.md https://revampkey.com/marketplace/readwise/skills/$s/SKILL.md
done

Ask in plain language, for example “Quiz me on five of my highlights about habit formation and grade my answers.”

RevampKey or copy the files?

In RevampKey

One click when you connect Readwise
Updated for you when a skill improves
Removed when you disconnect
The MCP server is set up for you
800+ other connectors, same way

Download free

Copy into your project

One command per project
Run it again to get updates
You connect the Readwise MCP server yourself
Works in Claude Code, Cursor, Codex and VS Code

See the command

Readwise skills FAQ

What is a Readwise agent skill?

A SKILL.md file: a short playbook an AI agent loads when your request matches it. Each Readwise skill describes one job, which Readwise tools to use in which order, what to check first and when to stop and ask you.

Do the Readwise skills change anything on their own?

1 of the 4 only read. The others tell the agent to show you the change and wait for a yes before it creates, edits or deletes anything in Readwise.

Which tools can use these skills?

Any agent that reads the open Agent Skills format: Claude Code, Cursor, Codex, VS Code with Copilot and RevampKey. In RevampKey they are attached when you connect Readwise; elsewhere you copy the folders into your project or skills directory.

Do I need the Readwise MCP server too?

Yes. The skills tell the agent how to do the work; the Readwise MCP server gives it the tools to do it. The Readwise MCP setup guide covers every client.

Readwise MCP server setup · This page as Markdown

Put Readwise’s best workflows in your agent

Download RevampKey, connect Readwise and ask your first question in about a minute.

Download RevampKey Connect Readwise · 1 click

All 4 Readwise skills

Use Readwise with AI

Use it when

Tools it uses

Quiz yourself on your Readwise highlights

Use it when

Tools it uses

Digest your Readwise library with AI

Use it when

Tools it uses

Triage your Reader inbox

Use it when

Tools it uses

Get all 4 without copying a file

How Readwise skills work

How to install Readwise skills

RevampKey or copy the files?

In RevampKey

Copy into your project

Readwise skills FAQ

Put Readwise’s best workflows in your agent

Skills for related tools