← Back to Skills Marketplace
346
Downloads
1
Stars
2
Active Installs
8
Versions
Install in OpenClaw
/install reading-tracker
Description
个人阅读管理与笔记系统。用于记录读书进度、管理书摘与思考、生成阅读报告。支持渐进式阅读法：书摘记录→每周回顾→月度串联。触发词："开始读"、"记录书摘"、"阅读进度"、"读完"、"复习"、"本月读了什么"。
Usage Guidance
This skill appears coherent and local-only: it stores notes and schedule data under ~/.qclaw/workspace/reading and uses an included Python CLI to manage files and generate reports. Before installing, consider: 1) Privacy — your reading notes are stored unencrypted in your home directory; if they contain sensitive info, back them up or encrypt them yourself. 2) Inspect the included script (scripts/reading_cli.py) to confirm behavior — it appears to do only local file I/O and scheduling data updates. 3) Cron behavior — the SKILL.md contains a cron schedule for weekly review triggers; confirm your agent/platform will handle these events as you expect and that no external delivery channel is configured. 4) Cross-device/sync — there is no network sync built in; if you want syncing, use a trusted mechanism. If you want, I can fully review the truncated portion of the generate-report code or search for network calls or exec usage before you install.
Capability Analysis
Type: OpenClaw Skill
Name: reading-tracker
Version: 0.0.2
The reading-tracker skill bundle is a legitimate tool for managing personal reading notes and schedules. The core logic in 'scripts/reading_cli.py' performs standard file I/O operations within a dedicated local workspace (~/.qclaw/workspace/reading) and uses only standard Python libraries. There is no evidence of data exfiltration, malicious command execution, or harmful prompt injection; all instructions in 'SKILL.md' and 'references/' are strictly aligned with the stated purpose of tracking books and generating reading reports.
Capability Assessment
Purpose & Capability
Name/description (reading tracker, notes, spaced repetition) match what the files and SKILL.md do: create book note files, store a library and schedule JSON, record quotes, schedule reviews, and generate local reports. No unexplained requests for cloud credentials, unrelated binaries, or external services.
Instruction Scope
SKILL.md instructs actions consistent with the stated purpose: creating note files, updating library.json and schedule.json, generating reports, and scheduling cron-triggered review reminders. The runtime instructions and included CLI operate only on the declared workspace paths and do not instruct reading unrelated system files, environment variables, or sending data to external endpoints.
Install Mechanism
There is no install spec (instruction-only), which is low-risk. However, the skill bundle includes a Python script (scripts/reading_cli.py) that will be present if the skill is installed; that script performs local file I/O. No external downloads, package installs, or archive extraction are used.
Credentials
The skill requests no environment variables, no credentials, and no config paths beyond its own workspace. All data it touches is stored under the user home path (~/.qclaw/workspace/reading), which is coherent with its purpose.
Persistence & Privilege
always:false and ordinary model invocation are used. The skill does write persistent files into its own workspace, but it does not request elevated privileges, modify other skills, or declare permanent system-wide presence.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install reading-tracker - After installation, invoke the skill by name or use
/reading-tracker - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.0.2
**Changelog for reading-tracker v0.0.2**
- Simplified the workflow for starting a new book by removing the "Title Calibration" step.
- Updated the book note template: replaced "我的原话 / 提炼要点" sections with a streamlined "Quote" and "Reflection" format.
- Removed AI-structured highlighting in book notes to focus on user reflections.
- No new file changes detected; documentation (SKILL.md) updated for clarity and brevity.
v0.0.1
reading-tracker 1.0.0
- Initial release of a personal reading management and note-taking system.
- Track reading progress, book highlights, thoughts, and generate reports.
- Supports a progressive workflow: quote capture → weekly review → monthly synthesis.
- Spaced repetition reminders using Ebbinghaus intervals.
- Natural language triggers in both Chinese and English.
- Data organized by book, review period, and report; includes CLI tools and report generation scripts.
v1.0.5
- Refreshed documentation: SKILL.md now features clear bilingual (Chinese/English) workflow for all core features, guidance, and templates.
- Updated description to prioritize concise bilingual trigger phrases and core use cases.
- Removed outdated evaluations file; added _meta.json for better metadata management.
- No changes to functionality or commands—this release focuses on improved clarity for all users.
v1.0.4
- English documentation and workflow clarified and made more concise.
- Skill description updated for clarity and broader use of English triggers.
- Instructions and templates simplified, emphasizing core steps: start, capture, finish, review, and report.
- Data structure and report format refined for easier integration and consistent record-keeping.
- Spaced repetition and interaction rules now described in a direct, user-friendly style.
- Chinese language content and examples removed for a streamlined, English-first approach.
v1.0.3
- Added an evaluation file: `evals/evals.json`
- Expanded skill trigger description to cover any reading-related topic in both Chinese and English, enabling broader and more flexible activation.
- No changes to core workflow or data structure.
v1.0.2
- Introduced book title calibration during "Start Reading" to confirm full book names, preventing confusion from abbreviations or nicknames.
- Updated book note template: each quote now keeps the user's full original statement and adds a structured summary, both recorded together.
- Clarified workflow to actively verify and record complete book titles before tracking reading progress.
- Emphasized that the user's original quote is logged exactly as stated, alongside AI-structured key points.
- No changes to scripts or storage structure; main changes are to reading workflow and note-taking precision.
v1.0.1
- Improved documentation: all key sections now include English translations alongside Chinese text.
- Clarified core workflows, note templates, and interaction rules in both languages.
- Enhanced examples to be fully bilingual for easier understanding by a broader audience.
- Added concise English explanations to complex concepts (e.g., review algorithm, monthly report).
v1.0.0
reading-tracker v1.0.0
- Initial release of a personal reading management and note-taking system.
- Features tracking of reading progress, book excerpts, reflections, and monthly/annual reports.
- Supports spaced repetition reviews (Ebbinghaus curve) and structured output prompts.
- Provides report generation with reading stats, calendar visualization, and cross-book insights.
- Includes CLI tools for managing notes, reports, and review schedules.
- Designed for Chinese and English users; supports workflows for 30–50 books/year.
Metadata
Frequently Asked Questions
What is Reading Tracker?
个人阅读管理与笔记系统。用于记录读书进度、管理书摘与思考、生成阅读报告。支持渐进式阅读法：书摘记录→每周回顾→月度串联。触发词："开始读"、"记录书摘"、"阅读进度"、"读完"、"复习"、"本月读了什么"。 It is an AI Agent Skill for Claude Code / OpenClaw, with 346 downloads so far.
How do I install Reading Tracker?
Run "/install reading-tracker" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Reading Tracker free?
Yes, Reading Tracker is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Reading Tracker support?
Reading Tracker is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Reading Tracker?
It is built and maintained by tt_ff117 (@ttff117); the current version is v0.0.2.
More Skills