← Back to Skills Marketplace
theshadowrose

Book Notes

by Shadow Rose · GitHub ↗ · v1.0.1 · MIT-0
cross-platform ✓ Security Clean
657
Downloads
0
Stars
4
Active Installs
2
Versions
Install in OpenClaw
/install book-notes
Description
Capture reading notes through conversation, organize by book, generate summaries, track reading list. Never lose an insight from a book again.
README (SKILL.md)

BookNotes � Reading Notes & Book Tracker

Capture reading notes through conversation, organize by book, generate summaries, track reading list. Never lose an insight from a book again.

Read a book. Tell your agent what you learned. It organizes everything.

Usage

You: "Reading Thinking Fast and Slow — Ch3. Key insight: System 1 makes 
      fast judgments that System 2 often just rationalizes."
Agent: "Added. You're on chapter 3/38. This connects to your Ch1 note 
        about cognitive biases being invisible to the person experiencing them."

Features

  • Conversational capture — just talk about what you read
  • Per-book organization — notes filed by book and chapter
  • Cross-reference — connects related ideas across books
  • Reading list — to-read, reading, finished
  • Book summaries — auto-generated from your notes
  • Key quotes — tag and search memorable quotes
  • Reading stats — books/month, pages/day, genre breakdown

Data Structure

books/
  thinking-fast-and-slow/
    metadata.yaml
    notes.md
    summary.md
    quotes.md
reading-list.md
stats.md

⚠️ Disclaimer

This software is provided "AS IS", without warranty of any kind, express or implied.

USE AT YOUR OWN RISK.

  • The author(s) are NOT liable for any damages, losses, or consequences arising from the use or misuse of this software — including but not limited to financial loss, data loss, security breaches, business interruption, or any indirect/consequential damages.
  • This software does NOT constitute financial, legal, trading, or professional advice.
  • Users are solely responsible for evaluating whether this software is suitable for their use case, environment, and risk tolerance.
  • No guarantee is made regarding accuracy, reliability, completeness, or fitness for any particular purpose.
  • The author(s) are not responsible for how third parties use, modify, or distribute this software after purchase.

By downloading, installing, or using this software, you acknowledge that you have read this disclaimer and agree to use the software entirely at your own risk.

DATA DISCLAIMER: This software processes and stores data locally on your system. The author(s) are not responsible for data loss, corruption, or unauthorized access resulting from software bugs, system failures, or user error. Always maintain independent backups of important data. This software does not transmit data externally unless explicitly configured by the user.

Support & Links
🐛 Bug Reports [email protected]
☕ Ko-fi ko-fi.com/theshadowrose
🛒 Gumroad shadowyrose.gumroad.com
🐦 Twitter @TheShadowyRose
🐙 GitHub github.com/TheShadowRose
🧠 PromptBase promptbase.com/profile/shadowrose

Built with OpenClaw — thank you for making this possible.

🛠️ Need something custom? Custom OpenClaw agents & skills starting at $500. If you can describe it, I can build it. → Hire me on Fiverr

Usage Guidance
This skill appears coherent and local-only, but review and consider the following before installing: (1) it will create and write files in the agent's current working directory (./books by default) — ensure that location and file permissions are acceptable; (2) running the code requires a Node environment; (3) keep backups if notes are important; (4) run in a sandbox or with least privilege (don't run as root) if you distrust the source; (5) inspect the small src/book-notes.js file (no network calls or credential access are present) and confirm you are comfortable with local file storage behavior.
Capability Analysis
Type: OpenClaw Skill Name: book-notes Version: 1.0.1 The BookNotes skill bundle is a straightforward tool for organizing reading notes and tracking book progress. The implementation in `src/book-notes.js` uses safe slugification (regex-based) to prevent path traversal vulnerabilities and performs standard local file operations consistent with its stated purpose. There is no evidence of data exfiltration, network activity, or malicious prompt injection instructions in `SKILL.md` or `README.md`.
Capability Assessment
✓ Purpose & Capability
The name/description describe note capture, per-book organization, quotes, summaries and a reading list. The included Node module implements addBook, addNote, addQuote, list and stats and reads/writes files under a books directory — all coherent with the stated purpose. There are no unrelated dependencies or credential requests.
✓ Instruction Scope
SKILL.md focuses on conversational capture and local storage, and explicitly states data is stored locally. The instructions do not direct the agent to read unrelated files, environment variables, or transmit data externally. The code likewise performs only filesystem operations within the booksDir.
✓ Install Mechanism
There is no install spec (instruction-only), and the single code file uses only Node core modules (fs, path). No network downloads or external package installs are requested. Note: running the skill requires a Node runtime or an environment that can execute the provided module.
✓ Credentials
The skill requires no environment variables, credentials, or config paths. The code does not reference process.env or external tokens. Its file I/O (creating ./books, writing metadata and notes) is proportionate to storing reading notes.
✓ Persistence & Privilege
The skill is not always-enabled and does not request elevated platform privileges. It persists data only to a local ./books directory it creates; it does not modify other skills or system-wide agent settings.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install book-notes
  3. After installation, invoke the skill by name or use /book-notes
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
- Updated skill name to "BookNotes Reading Notes and Book Tracker" (removed special character). - Incremented version number to 1.0.1. - No changes to feature set or functionality.
v1.0.0
Initial upload
Metadata
Slug book-notes
Version 1.0.1
License MIT-0
All-time Installs 4
Active Installs 4
Total Versions 2
Frequently Asked Questions

What is Book Notes?

Capture reading notes through conversation, organize by book, generate summaries, track reading list. Never lose an insight from a book again. It is an AI Agent Skill for Claude Code / OpenClaw, with 657 downloads so far.

How do I install Book Notes?

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

Is Book Notes free?

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

Which platforms does Book Notes support?

Book Notes is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Book Notes?

It is built and maintained by Shadow Rose (@theshadowrose); the current version is v1.0.1.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 Comments