Installation
Prerequisite: first, make sure you have the Readwise MCP server or CLI installed (whichever you prefer!)
If you're using an AI agent, you can probably just tell your agent to install the skills from this repo and let it do the work:
Install the skills from here https://github.com/readwiseio/readwise-skills so that you can use them. If neither is installed yet, the Readwise MCP server is a remote MCP server hosted at https://mcp2.readwise.io/mcp OR the CLI can be installed via `npm i @readwise/cli`. You only need one of these installed to use the skills.
If that doesn't work:
npx skills (recommended)
npx skills is a very easy way to install these skills; it will set them to work with any LLM app you might use (Claude, Codex, Opencode, Cursor, etc). Run this from the terminal:
npx skills add readwiseio/readwise-skills
Manual Installation
Copy the skills/ directory into your agent's skills path:
- Claude Code:
~/.claude/skills/or.claude/skills/in your project - Codex CLI:
~/.codex/skills/ - OpenCode:
~/.opencode/skills/
Claude Code Installation (with MCP Included)
Installs the MCP server and all skills in one command:
/plugin marketplace add readwiseio/readwise-skills
/plugin install readwise@readwise-skills
Claude Cowork Installation (with MCP Included)
In the Cowork sidebar: Customize → "+" → Add marketplace from GitHub → enter readwiseio/readwise-skills. Then browse and install the Readwise plugin.
The Skills
We've started this repo off with a few skills we've really enjoyed using, but so much more is possible!
Personalization
Run the build-persona skill first to generate a reader_persona.md file. The other skills (triage, feed-catchup, quiz) read this file to personalize their output to your interests, goals, and reading style.
Please share yours!
These skills are just a starting point, quickly hacked up by the Readwise team based on what's been for us to try. There is still so so much more that can be done. Please make a pull request adding your own favorite skills, or shoot us an email at any time :)
