← Back to Skills Marketplace
harrylabsj

Reading Manager

by haidong · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
420
Downloads
0
Stars
4
Active Installs
1
Versions
Install in OpenClaw
/install reading-manager
Description
Personal reading management system for tracking books, articles, reading progress, notes, and generating reading reports. Use when: (1) recording books and a...
Usage Guidance
This package appears to implement a normal local CLI reading manager. Before installing: (1) be aware it will create ~/.config/reading-manager/reading.db (local unencrypted storage of your entries and any API keys you add); (2) network lookups use Google Books (optional) — you can use the tool offline or avoid adding API keys; (3) installation is via pip locally (pip install -e .) — review the included source if you want to confirm no unexpected behavior; (4) if you plan to add API keys, understand they will be stored in the SQLite config table. If you want extra caution, run the package in a sandboxed environment or inspect/execute the code manually before giving it access to your primary account/home directory.
Capability Analysis
Type: OpenClaw Skill Name: reading-manager Version: 1.0.0 The 'reading-manager' skill is a legitimate personal reading management system. It implements a CLI tool using Python, SQLite for local data storage in ~/.config/reading-manager/, and the Google Books API for metadata retrieval. Analysis of the source code (src/reading_cli.py, src/reading_api/books.py) and instructions (SKILL.md) shows no evidence of data exfiltration, malicious execution, or prompt injection. The behavior is entirely consistent with the stated purpose of tracking books and reading progress.
Capability Assessment
Purpose & Capability
Name/description match the included code and CLI: the package implements book/article management, progress, notes, lists, goals and reporting. The included Python modules implement the features described in SKILL.md (SQLite DB under ~/.config/reading-manager/reading.db, Google Books/Douban API lookups, CLI commands).
Instruction Scope
SKILL.md only instructs installing locally (pip install -e .) and running the CLI; runtime behavior is limited to local DB operations and optional Google Books/Douban lookups. One side-effect: reading_cli calls init_database() at import, so merely importing/running the CLI will create the data directory and database file (~/.config/reading-manager/reading.db). API lookups use requests to Google Books; Douban API is a placeholder. No instructions to read unrelated system files or send data to unexpected endpoints.
Install Mechanism
There is no registry install spec in the metadata, but SKILL.md and README instruct a local pip editable install (pip install -e .). All source is included in the bundle (no external downloads during install). This is a low-risk install model but requires the user to run pip locally.
Credentials
The skill declares no required environment variables or external credentials. It does include configuration keys for API keys (api.google_books_key, api.douban_key) which are stored in the local config table in the SQLite DB if populated. If you provide API keys, they will be stored locally and not encrypted. No other credentials or unrelated env vars are requested.
Persistence & Privilege
The skill is not forced-always, does not request platform-wide privileges, and does not modify other skills. It stores persistent data locally under the user's home (~/.config/reading-manager/reading.db). The only persistence behavior to note is automatic DB creation when the CLI module is imported.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install reading-manager
  3. After installation, invoke the skill by name or use /reading-manager
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of Reading Manager – a personal reading management system. - Track books, articles, papers, and documents (with ISBN, URL, or manual entry) - Monitor reading progress, including page numbers, percentages, time spent, and speed analytics - Record and manage reading notes and highlights, with support for tagging and Markdown export - Organize works in lists: want to read, currently reading, finished, and custom lists - Generate reading reports (monthly, yearly, stats, and trends) - Set and view reading goals, with progress tracking and reminders - Data stored locally in SQLite; supports export/import (JSON); Python CLI with rich terminal UI
Metadata
Slug reading-manager
Version 1.0.0
License MIT-0
All-time Installs 4
Active Installs 4
Total Versions 1
Frequently Asked Questions

What is Reading Manager?

Personal reading management system for tracking books, articles, reading progress, notes, and generating reading reports. Use when: (1) recording books and a... It is an AI Agent Skill for Claude Code / OpenClaw, with 420 downloads so far.

How do I install Reading Manager?

Run "/install reading-manager" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Reading Manager free?

Yes, Reading Manager is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Reading Manager support?

Reading Manager is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Reading Manager?

It is built and maintained by haidong (@harrylabsj); the current version is v1.0.0.

💬 Comments