A local-first CLI productivity toolkit for managing reading lists, progress tracking, and book reviews through timestamped logging.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install bookshelf
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install bookshelf using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Bookshelf?
Bookshelf is a comprehensive command-line utility designed for bibliophiles and researchers who want to maintain full control over their reading data. As part of the ecosystem of Openclaw Skills, it provides a streamlined workflow for adding books, setting goals, and tracking daily progress without needing external APIs or cloud dependencies. The skill emphasizes local data ownership by storing everything in plain-text logs that are easy to parse, grep, and backup.
By integrating Bookshelf into your terminal workflow, you can transform reading from a passive activity into a structured habit. This skill is particularly valuable for developers and power users who utilize Openclaw Skills to automate their personal knowledge management. It bridges the gap between digital terminal environments and physical or digital reading lists, ensuring your library metadata is always searchable and actionable.
Bookshelf Use Cases
- Managing a backlog of books with prioritization to decide what to read next.
- Tracking daily reading progress by page or chapter to maintain consistency.
- Building a personal database of book reviews and key takeaways for future reference.
- Monitoring long-term reading goals through automated stats and weekly review reports.
- Organizing a vast library using tags and genres for quick filtering and searching.
How Bookshelf Works
- The user interacts with the skill via the command line to log activities like adding a book or recording progress.
- The skill captures the input and prepends a precise timestamp to ensure chronological integrity.
- Data is appended to specific .log files located in the local share directory, categorized by entry type.
- Users can query the data using search or stats commands which scan the local log files in real-time.
- The skill allows for exporting the entire database into structured formats like JSON or CSV for external analysis or visualization.
Bookshelf Setup
To get started with this skill within your Openclaw Skills environment, ensure you have Bash 4.0 or higher. Installation involves downloading the script and ensuring it has execution permissions.
# Navigate to your skills directory
cd ~/ai-skills
# Ensure the bookshelf script is executable
chmod +x bookshelf
# Initialize the data directory by checking status
./bookshelf status
No API keys or internet connection are required for operation.
Bookshelf Data Schema & Taxonomy
Bookshelf uses a flat-file taxonomy for data organization. All records are stored in ~/.local/share/bookshelf/ using a standardized format: YYYY-MM-DD HH:MM|value.
| File | Description |
|---|---|
| add.log | Initial entries for books and items |
| track.log | Progress logs including pages or chapters read |
| review.log | Qualitative assessments and ratings |
| archive.log | Records of finished or discarded books |
| history.log | A master log of every action taken within the skill |
Bookshelf Advanced Features
- Multi-format export capabilities for JSON, CSV, and TXT integration.
- Built-in streak tracking to monitor daily reading habit consistency.
- Comprehensive search functionality across all log categories.
- Weekly review workflows to summarize reading achievements and adjust goals.
- Resource-efficient status monitoring providing disk usage and entry counts.
SKILL.md
Loading
Related Openclaw Skills
SEO Optimizer
A comprehensive SEO toolkit for keyword research, meta tag optimization, and automated content analysis.
Image Generation Skill
A versatile AI image generation and editing tool supporting multiple providers like OpenRouter and Kie.ai for seamless visual creation.
Teamgram BFF Aggregation Layer Reference
A detailed technical map of the Backend-for-Frontend (BFF) layer in Teamgram Server, detailing all 268 RPC handlers for Telegram-compatible API development.
Teamgram Tool Services Knowledge Base
A comprehensive technical reference for managing core infrastructure services within the Teamgram Server ecosystem.
Teamgram MTProto Protocol Reference
A technical documentation skill providing deep insights into the MTProto protocol implementation within the Teamgram Server architecture.
Teamgram Messaging Sync
A technical documentation skill detailing the Kafka-driven message delivery and synchronization architecture of the Teamgram Server.
Featured*
