Summary

This repository offers AI-powered skills for Readwise and Reader data, targeting AI agent users (Claude, Codex, Cursor). It enables sophisticated inbox triage, personalized learning, and content generation via conversational AI, transforming reading data into actionable insights and active engagement.

How It Works

Skills integrate with the Readwise MCP server or CLI, serving as tools for AI agents. Installation is streamlined via npx skills or directly within supported AI environments. The core approach involves AI agents invoking these skills to process user data. A key feature is the build-persona skill, which generates a personalized profile (reader_persona.md) to tailor other skills' outputs to individual user preferences and goals.

Quick Start & Requirements

• Prerequisite: Readwise MCP server (https://mcp2.readwise.io/mcp) or CLI (npm i @readwise/cli) installed.
• Recommended Install: npx skills add readwiseio/readwise-skills configures skills for various LLM apps.
• Alternative Installs: Manual copying of skills/ to agent paths (e.g., ~/.claude/skills/) or using in-app commands like /plugin marketplace add readwiseio/readwise-skills in Claude.
• Dependencies: Node.js (for CLI), compatible AI agent, Readwise account.

Highlighted Details

• Core Skills: Includes readwise-cli, readwise-mcp for agent interaction, plus triage, feed-catchup, and quiz for content management and learning.
• Content Generation: Features book-review for drafting reviews from highlights and now-reading-page for generating a personal "What I'm Reading" webpage.
• Data Analysis: Offers highlight-graph for visualizing idea connections and surprise-me for uncovering reading history insights.
• Personalization: build-persona skill creates reader_persona.md to tailor skill output to user interests.

Maintenance & Community

Initiated by the Readwise team, the project actively encourages community contributions via pull requests and email feedback. Specific community channels or contributor details are not provided in the README.

Licensing & Compatibility

License information is not specified in the provided README. Compatibility for commercial use or closed-source linking cannot be determined from this text.

Limitations & Caveats

Described as a "starting point, quickly hacked up," the project is under active development and expected to evolve. Users should anticipate changes and are invited to contribute to expanding its capabilities.