← Back to Skills Marketplace
Book Highlights
by
heardlyapp
· GitHub ↗
· v1.0.0
· MIT-0
154
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install book-highlights
Description
Extract key highlights and quotes from books. Get the most important passages and insights from any book.
README (SKILL.md)
book-highlights
Extract key highlights and quotes from books.
What it does
- Search books by title or author
- Extract 5-10 key highlights and quotes
- Return formatted highlights with context
- Show Heardly highlights if available
- Support multiple book sources
When to use this skill
Use this skill when the user asks:
- "What are the highlights from Atomic Habits?"
- "Show me the best quotes from Deep Work"
- "Key ideas from Thinking, Fast and Slow"
- "Important passages from Principles"
- "Highlights of The Lean Startup"
Installation
clawhub install book-highlights
Usage
const BookHighlightsSkill = require('book-highlights');
const skill = new BookHighlightsSkill();
// Get highlights (returns formatted text)
const result = await skill.getHighlights({
query: 'Atomic Habits',
limit: 10
});
console.log(result); // Directly readable text output
Output
Formatted text with:
- Book title and author
- 5-10 key highlights/quotes
- Context for each highlight
- Heardly source attribution
- Ready to display to users
Data Sources
- Heardly Database (5904 books) — highlights field
- Extracted from summaries — key passages
License
MIT
Usage Guidance
This skill appears to be benign and self-contained: it reads a local data file (data/books.json) and extracts highlights without network calls or credential access. Before installing, check whether the package you install includes the Heardly data file (data/books.json) or whether you need to supply it; otherwise the skill will report 'No book found' for queries. Also note the README/SKILL.md claim of a 5904-book Heardly DB — verify that the data source is actually included or provided by your environment. Because it ships a CLI, consider running it in a sandbox or review the installed files to ensure the expected data directory is present. If you intend to use copyrighted highlights at scale, ensure you have the right to redistribute or display them.
Capability Analysis
Type: OpenClaw Skill
Name: book-highlights
Version: 1.0.0
The book-highlights skill is a standard utility for searching and formatting book quotes from a local JSON database. The code in index.js and cli.js performs basic string matching and file reading without any network requests, external dependencies, or suspicious execution patterns.
Capability Assessment
Purpose & Capability
The skill's name, description, and code align: it searches a local Heardly database and extracts highlights from book summary/description text. However, SKILL.md and README advertise a 'Heardly Database (5904 books)' and multi-source support; the package does not include a data/ directory or books.json in the provided manifest. That means the core advertised capability (returns many Heardly highlights) is not available out of the box and requires an external data file or additional source integration.
Instruction Scope
SKILL.md contains only normal usage/installation guidance and examples. The runtime code only reads a local data file (data/books.json) and operates on the provided text; it does not access other system paths, environment variables, or external endpoints. The docs do not mention the required local data file, which is a scope/usage omission (the skill silently falls back to an empty DB if data is missing).
Install Mechanism
No install spec is present and the package is instruction+code only. There are no downloads, extract steps, or package-install side effects specified. package.json is small and defines a CLI entrypoint; this is low-risk.
Credentials
The skill requires no environment variables, credentials, or config paths. The code does not attempt to read environment variables or credentials. This is proportionate to its purpose.
Persistence & Privilege
The skill does not request elevated persistence (always: false) and does not modify other skills or system configuration. It only reads a local file relative to its installation directory.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install book-highlights - After installation, invoke the skill by name or use
/book-highlights - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of book-highlights skill:
- Extracts 5–10 key highlights and quotes from books by title or author.
- Returns formatted highlights with context, title, author, and source attribution.
- Supports multiple book sources, including Heardly highlights and extracted summaries.
- Ready-to-display output for end users.
Metadata
Frequently Asked Questions
What is Book Highlights?
Extract key highlights and quotes from books. Get the most important passages and insights from any book. It is an AI Agent Skill for Claude Code / OpenClaw, with 154 downloads so far.
How do I install Book Highlights?
Run "/install book-highlights" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Book Highlights free?
Yes, Book Highlights is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Book Highlights support?
Book Highlights is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Book Highlights?
It is built and maintained by heardlyapp (@heardlyapp); the current version is v1.0.0.
More Skills