skill CX Codex

readwise-cli — Claude Code skill: features and setup

Q: How do I install readwise-cli in Claude Code?

Run `npx skills add readwiseio/readwise-skills --skill readwise-cli -a claude-code`. The skill file is placed at `~/.claude/skills/readwise-cli/SKILL.md`.

Q: What do I need to use readwise-cli?

Install `@readwise/cli` and authenticate with a Readwise access token using `readwise login-with-token `.

This skill guides an agent through the Readwise CLI to search, read, and manage Reader documents and Readwise highlights. Use it to work with your reading library from the terminal.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓

npx skills add readwiseio/readwise-skills --skill readwise-cli -a claude-code

Open on GitHub

What readwise-cli does

The skill covers CLI commands for finding and browsing Reader documents and Readwise highlights. An agent can fetch a document’s content, save a URL or Markdown, create highlights and notes, change tags, move documents, and export documents as a ZIP of Markdown files. Search supports semantic queries and filters.

Install @readwise/cli with npm install -g @readwise/cli, then authenticate with a Readwise access token using readwise login-with-token <token>. Commands accept --help for option details; --json returns machine-readable output. There is an important constraint when creating a Reader highlight: the supplied HTML must match the document’s HTML exactly. The skill also describes daily review and bulk metadata edits.

What it helps with

search Reader documents by topic or author
retrieve document text and its highlights
save a URL or Markdown in Reader
move documents and change their tags
export documents as Markdown files

Example prompts for the agent

Search my saved Reader documents for machine learning and show their titles and authors.
Save this link to Reader with the research tag, then move it to the archive.
Find my recent highlights about memory and prepare today’s review.

How to install readwise-cli

1Skills CLI (Vercel)

npx skills add readwiseio/readwise-skills --skill readwise-cli -a claude-code

2Manually: put the files in place

~/.claude/skills/readwise-cli/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/readwise-cli/

1Skills CLI (Vercel)

npx skills add readwiseio/readwise-skills --skill readwise-cli -a codex

2Manually: put the files in place

.agents/skills/readwise-cli/SKILL.md

For all projects use ~/.agents/skills/

1Skills CLI (Vercel)

npx skills add readwiseio/readwise-skills --skill readwise-cli -a cursor

2Manually: put the files in place

.cursor/skills/readwise-cli/SKILL.md

Cursor also reads .agents/skills/ and .claude/skills/

1GitHub CLI

gh skill install readwiseio/readwise-skills readwise-cli

2Manually: put the files in place

.github/skills/readwise-cli/SKILL.md

1Skills CLI (Vercel)

npx skills add readwiseio/readwise-skills --skill readwise-cli -a gemini-cli

2Platform CLI

gemini skills install https://github.com/readwiseio/readwise-skills --path skills/readwise-cli

Manually: put the files in place

.devin/skills/readwise-cli/SKILL.md

The legacy .windsurf/skills/ path still works

Skills CLI (Vercel)

npx skills add readwiseio/readwise-skills --skill readwise-cli -a opencode

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about readwise-cli

How do I install readwise-cli in Claude Code?

Run npx skills add readwiseio/readwise-skills --skill readwise-cli -a claude-code. The skill file is placed at ~/.claude/skills/readwise-cli/SKILL.md.

What does readwise-cli do?

It guides an agent in using the CLI to search and manage Reader documents and Readwise highlights, including reading, saving, and editing content.

What do I need to use readwise-cli?

Install @readwise/cli and authenticate with a Readwise access token using readwise login-with-token <token>.

find-skills vercel-labs Discovers and installs agent skills from skills.sh directly inside your coding assistant. Handy when you need domain-specific workflows for a project. CX Codex +1 4,000,000installs grill-me Matt Pocock grill-me interviews you about a plan or design to expose gaps and sharpen decisions. Use it before implementation starts. 1,424,476installs grill-with-docs Matt Pocock This skill interviews you about a plan or design and creates ADRs and a glossary along the way. Use it when decisions need sharper definition. 1,219,756installs handoff Matt Pocock Creates a handoff document from the current conversation so another agent can continue the work. Use it when a task moves to a new session or agent. 1,038,491installs grilling Matt Pocock Stress-test a plan, decision, or idea through structured rounds of questions. Use it when you need to expose assumptions before acting. 979,543installs teach Matt Pocock Turns the current directory into a learning workspace and keeps progress across sessions. Use it when learning needs to support a concrete goal in your project. 862,247installs

From the same set11

quiz This skill quizzes you on documents from Readwise Reader, one question at a time, then grades your answers. Use it to check what you remember after reading. CX Codex +1 609installs book-review This skill generates a long-form book review by connecting the book's core ideas to your Readwise library. Use it when you want a review that goes beyond one book and draws on your entire reading history. CX Codex +1 589installs reader-recap Generates a conversational digest of recent Readwise Reader activity, covering archived texts, highlights, and notes. It pulls out questions and follow-ups. CX Codex +1 507installs feed-catchup Cleans up your unread Readwise Reader RSS feed, highlights the five best articles, and lets you triage the rest in batches. CX Codex +1 501installs build-persona This skill turns your Readwise Reader library into a reader_persona.md profile so triage, quiz and other skills can tailor their output to you. CX Codex +1 492installs triage The skill walks you through recent Readwise Reader saves one at a time and argues each case for and against reading. Handy when the inbox has piled up and you don't know where to start. CX Codex +1 470installs now-reading-page Turns your Readwise Reader library into a single HTML page showing what you are reading now and what you finished recently. CX Codex +1 455installs surprise-me The skill digs through your Readwise highlights and saved documents to surface one surprising thing about you as a reader. CX Codex +1 445installs