书架
Bookshelf
by BytesAgain
Track reading progress, rate finished books, and manage your library. Use when logging books, reviewing reading stats, or planning reading goals.
安装
claude skill add --url github.com/openclaw/skills/tree/main/skills/ckchzh/bookshelf文档
Bookshelf
A personal productivity toolkit for managing books, reading plans, progress tracking, reviews, and reading habits — all from the command line with timestamped local logging, tagging, archiving, and weekly review workflows.
Commands
| Command | Description |
|---|---|
bookshelf add <input> | Add a book or item to your shelf. Without args, shows recent add entries |
bookshelf plan <input> | Record a reading plan or goal. Without args, shows recent plans |
bookshelf track <input> | Track reading progress. Without args, shows recent tracking entries |
bookshelf review <input> | Log a book review or assessment. Without args, shows recent reviews |
bookshelf streak <input> | Record a reading streak or consistency milestone. Without args, shows recent streaks |
bookshelf remind <input> | Set a reading reminder note. Without args, shows recent reminders |
bookshelf prioritize <input> | Record a prioritization decision. Without args, shows recent priorities |
bookshelf archive <input> | Archive a finished or dropped book. Without args, shows recent archives |
bookshelf tag <input> | Tag or categorize a book. Without args, shows recent tag entries |
bookshelf timeline <input> | Record a reading timeline entry or milestone. Without args, shows recent timeline entries |
bookshelf report <input> | Generate and log a reading report. Without args, shows recent reports |
bookshelf weekly-review <input> | Record a weekly reading review summary. Without args, shows recent weekly reviews |
bookshelf stats | Show summary statistics across all entry types |
bookshelf search <term> | Search across all log entries for a keyword |
bookshelf recent | Show the 20 most recent activity entries |
bookshelf status | Health check — version, data dir, entry count, disk usage, last activity |
bookshelf export <fmt> | Export all data in json, csv, or txt format |
bookshelf help | Show all available commands |
bookshelf version | Print version (v2.0.0) |
Each command (add, plan, track, etc.) works the same way:
- With arguments: saves the entry with a timestamp to its dedicated
.logfile and records it in activity history - Without arguments: displays the 20 most recent entries from that command's log
Data Storage
All data is stored locally in plain-text log files:
~/.local/share/bookshelf/
├── add.log # Added books and items
├── plan.log # Reading plans and goals
├── track.log # Progress tracking entries
├── review.log # Book reviews and assessments
├── streak.log # Reading streak records
├── remind.log # Reminder notes
├── prioritize.log # Prioritization decisions
├── archive.log # Archived / finished books
├── tag.log # Tag and genre categorization
├── timeline.log # Reading timeline milestones
├── report.log # Reading reports and summaries
├── weekly-review.log # Weekly reading review summaries
└── history.log # Unified activity log with timestamps
Each entry is stored as YYYY-MM-DD HH:MM|<value> for easy parsing and export.
Requirements
- Bash 4.0+ (uses
set -euo pipefail) - Standard UNIX utilities:
date,wc,du,grep,head,tail,cat - No external dependencies or API keys required
- Works offline — all data stays on your machine
When to Use
- Reading list management — Use
addto build your to-read list,prioritizewhat to pick up next, andarchivebooks once finished or dropped - Reading habit tracking — Track daily pages or chapters with
track, maintain reading streaks withstreak, and review progress inweekly-review - Book review journaling — After finishing a book, use
reviewto log your thoughts, ratings, and key takeaways for future reference - Annual reading goals — Set yearly targets with
plan, track progress withstats, and generate periodic reports withreportto stay on pace - Genre and tag organization — Use
tagto categorize books by genre, topic, or mood, thensearchto find the right book for any occasion
Examples
Add books and start reading
# Add books to your shelf
bookshelf add "Atomic Habits by James Clear — recommended by Kelly"
bookshelf add "Deep Work by Cal Newport — productivity classic"
bookshelf add "Project Hail Mary by Andy Weir — sci-fi for fun"
# Tag them by genre
bookshelf tag "Atomic Habits: #self-help #habits #productivity"
bookshelf tag "Deep Work: #productivity #focus #career"
bookshelf tag "Project Hail Mary: #sci-fi #fiction #adventure"
# Prioritize what to read next
bookshelf prioritize "Atomic Habits — start this week, short chapters"
Track reading progress
# Track daily reading
bookshelf track "Atomic Habits — finished chapters 1-3, 45 pages"
bookshelf track "Atomic Habits — chapters 4-6, identity-based habits section"
# Record streaks
bookshelf streak "day 7 of reading at least 20 pages daily"
bookshelf streak "day 30 — one month streak! 🎉"
# Set a reminder
bookshelf remind "return library copy of Deep Work by April 20"
# Record a timeline milestone
bookshelf timeline "2024-04-01: started Atomic Habits reading challenge"
Review, report, and archive
# Write a book review
bookshelf review "Atomic Habits — 5/5. Best takeaway: habit stacking. Changed my morning routine."
# Weekly reading review
bookshelf weekly-review "Week 15: finished Atomic Habits (5/5), started Deep Work. Read 180 pages total."
# Generate a monthly report
bookshelf report "April: 2 books finished, 1 in progress. 620 pages read. On track for 24-book goal."
# Set reading plans
bookshelf plan "Q2 goal: finish 6 books — 2 non-fiction, 2 sci-fi, 2 technical"
# Archive finished books
bookshelf archive "Atomic Habits — completed 2024-04-10, review saved"
# Check overall stats
bookshelf stats
bookshelf recent
Search and export
# Search for a book or topic
bookshelf search "productivity"
# Export entire library as JSON
bookshelf export json
# Export as CSV for spreadsheet tracking
bookshelf export csv
# Health check
bookshelf status
Output
All commands print confirmation to stdout. Data is persisted in ~/.local/share/bookshelf/. Use bookshelf stats for an overview, bookshelf search <term> to find specific entries, or bookshelf export <fmt> to extract all data as JSON, CSV, or plain text.
Powered by BytesAgain | bytesagain.com | hello@bytesagain.com
相关 Skills
技能工坊
by anthropics
覆盖 Skill 从创建到迭代优化全流程：起草能力、补测试提示、跑评测与基准方差分析，并持续改写内容和描述，提升效果与触发准确率。
✎ 技能工坊把技能从创建、迭代到评测串成闭环，方差分析加描述优化，特别适合把触发准确率打磨得更稳。
PPT处理
by anthropics
处理 .pptx 全流程：创建演示文稿、提取和解析幻灯片内容、批量修改现有文件，支持模板套用、合并拆分、备注评论与版式调整。
✎ 涉及PPTX的创建、解析、修改到合并拆分都能一站搞定，连备注、模板和评论也能处理，做演示文稿特别省心。
PDF处理
by anthropics
遇到 PDF 读写、文本表格提取、合并拆分、旋转加水印、表单填写或加解密时直接用它，也能提取图片、生成新 PDF，并把扫描件通过 OCR 变成可搜索文档。
✎ PDF杂活别再来回切工具了，文本表格提取、合并拆分到OCR识别一次搞定，连扫描件也能变可搜索。
相关 MCP 服务
文件系统
编辑精选by Anthropic
Filesystem 是 MCP 官方参考服务器，让 LLM 安全读写本地文件系统。
✎ 这个服务器解决了让 Claude 直接操作本地文件的痛点，比如自动整理文档或生成代码文件。适合需要自动化文件处理的开发者，但注意它只是参考实现，生产环境需自行加固安全。
by wonderwhy-er
Desktop Commander 是让 AI 直接执行终端命令、管理文件和进程的 MCP 服务器。
✎ 这工具解决了 AI 无法直接操作本地环境的痛点，适合需要自动化脚本调试或文件批量处理的开发者。它能让你用自然语言指挥终端，但权限控制需谨慎，毕竟让 AI 执行 rm -rf 可不是闹着玩的。
EdgarTools
编辑精选by dgunning
EdgarTools 是无需 API 密钥即可解析 SEC EDGAR 财报的开源 Python 库。
✎ 这个工具解决了金融数据获取的痛点——直接让 AI 读取结构化财报，比如让 Claude 分析苹果的 10-K 文件。适合量化分析师或金融开发者快速构建数据管道。但注意，它依赖 SEC 网站稳定性，高峰期可能延迟。