Reading Manager
Paste the following prompt into your AI chat to install this skill:
Please install @user_15292d5a/yjkj-reading-manager according to https://skillhub.cn/install/skillhub.md.
About this skill
Problem Addressed
Personal reading material often lives across bookmarks, PDFs, and note apps, making book progress, excerpts, and goals hard to track as one coherent record. reading-manager targets this workflow by bringing books, articles, papers, and documents into a single local library, with structured fields for metadata, reading progress, notes, lists, and goals.
How It Works
It organizes data around core objects: books, reading_progress, notes, lists, and goals. Entries can be created via ISBN, URL, or manual input, and the tool can attempt to enrich book metadata using the Google Books API or Douban API. Progress tracking supports page numbers, percentage, reading time, and speed analysis; notes support highlights, annotations, tags, and Markdown export; lists cover want-to-read, currently reading, finished, and custom collections; reports can include monthly/annual statistics, category distribution, reading trends, and time reports. Data is stored locally by default at ~/.config/reading-manager/reading.db, using Python 3.8+, SQLite, Click, Rich, and requests.
Boundaries
It is best understood as a personal CLI tool for local record-keeping and review, rather than a real-time collaborative or multi-device synchronized system. Metadata enrichment depends on external APIs, so manual correction may be needed when network access is unavailable; report quality also depends on consistent entry and complete fields.
Use Cases
- Add recent paper links and ISBNs to a local library, then sort them into want-to-read, reading, and finished lists.
- Record page progress, highlights, and annotations after a chapter, then export a Markdown excerpt for writing.
- Summarize monthly reading time, category distribution, and annual goal progress at month-end.
- Import URL articles, fetch metadata, tag them, and file them into custom lists for topic-based lookup.
Best For
- Independent researchers who maintain personal reading lists and need unified records for papers, books, and articles.
- Technical engineers with annual reading goals who need page progress, time tracking, and reminders.
- Content editors collecting highlights and annotations who need tags and Markdown export into writing workflows.
- Knowledge workers doing personal review who need monthly and yearly category and trend reports.
Related Skills
Reads conversation-trace files to generate an animal- or mythology-based soul mirror card and Johari Window insights.
A Deling knowledge-base research workflow that clarifies intent, runs broad and vertical searches, supplements with web sources, validates diversity, and traces key claims.
A SiYuan knowledge-base management skill for double-link parent indexes, MOCs, numbered documents, tags, repo sync, and WeChat import workflows.
A structured workflow for academic literature reviews, covering multi-database search, screening, thematic synthesis, citation validation, and PDF output.