← Back to Skills Marketplace
Readwise Reader
by
Yingxin Wu
· GitHub ↗
· v0.2.3
· MIT-0
142
Downloads
1
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install readwise-reader
Description
Interact with Readwise Reader library to list, create, update, and delete documents. Use when the user wants to manage their saved articles, reading lists, o...
Usage Guidance
This skill is coherent with its purpose, but before installing: (1) verify the READWISE_ACCESS_TOKEN you provide is limited to the Readwise account you intend to use, (2) inspect the included scripts yourself (they are plain Python) and only run pip install for the listed dependencies in a controlled environment (virtualenv/container), and (3) be aware that listing/printing operations will output your library data (which could be written to files if you use --output).
Capability Analysis
Type: OpenClaw Skill
Name: readwise-reader
Version: 0.2.3
The skill bundle provides a legitimate set of tools for interacting with the Readwise Reader API. The Python scripts (e.g., `list_documents.py`, `create_document.py`, `utils.py`) implement standard API operations such as listing, creating, updating, and deleting documents using the official Readwise endpoint (https://readwise.io/api/v3). Authentication is handled via a user-provided environment variable (`READWISE_ACCESS_TOKEN`), and the code follows secure practices without any evidence of data exfiltration, unauthorized execution, or malicious prompt injection.
Capability Assessment
Purpose & Capability
Name/description (Readwise Reader) align with required binaries (python, pip), the single required env var (READWISE_ACCESS_TOKEN), and the scripts which call Readwise's API (BASE_URL = https://readwise.io). All requested resources are appropriate for the stated functionality.
Instruction Scope
SKILL.md and the scripts only reference Readwise API endpoints, local payload files, and optional .env usage. The instructions do not attempt to read unrelated system files, other environment variables, or transmit data to unexpected endpoints. Scripts read user-provided payloads and may write output files as documented (expected behavior).
Install Mechanism
There is no formal install spec (instruction-only in registry) but the package includes runnable Python scripts and a requirements.txt (httpx, python-dotenv). Users must run pip install -r scripts/requirements.txt manually; this is low-risk but the absence of an automated install step means callers should inspect/verify dependencies before running.
Credentials
The single required env var is READWISE_ACCESS_TOKEN (declared as primaryEnv) and is used exclusively for authentication to the Readwise API. No unrelated secrets or config paths are requested.
Persistence & Privilege
The skill is not always-enabled, does not request elevated system persistence, and does not modify other skills or system-wide agent settings. Autonomous invocation (default) is allowed but not combined with other concerning privileges.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install readwise-reader - After installation, invoke the skill by name or use
/readwise-reader - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.2.3
- Added homepage and metadata fields to the skill manifest for improved integration and discoverability.
- Metadata now describes required binaries, environment variables, and a primary environment variable for authentication.
- No changes to usage, command-line options, or main workflows.
v0.2.2
Initial Clawhub release with full Readwise Reader API integration including document management, bulk operations, and rate limit handling.
v0.2.1
Initial release to ClawHub: Full CRUD operations for Readwise Reader library with rate limit handling, JSON Lines streaming support, and comprehensive usage guide.
Metadata
Frequently Asked Questions
What is Readwise Reader?
Interact with Readwise Reader library to list, create, update, and delete documents. Use when the user wants to manage their saved articles, reading lists, o... It is an AI Agent Skill for Claude Code / OpenClaw, with 142 downloads so far.
How do I install Readwise Reader?
Run "/install readwise-reader" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Readwise Reader free?
Yes, Readwise Reader is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Readwise Reader support?
Readwise Reader is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Readwise Reader?
It is built and maintained by Yingxin Wu (@xinthink); the current version is v0.2.3.
More Skills