← Back to Skills Marketplace
Find Book
by
heardlyapp
· GitHub ↗
· v1.0.18
· MIT-0
177
Downloads
0
Stars
1
Active Installs
19
Versions
Install in OpenClaw
/install find-book
Description
Instantly find nonfiction books with Goodreads ratings, summaries, key concepts, and AI suggestions for enhancing your agent's knowledge files.
README (SKILL.md)
find-book
Local book search. 5904 nonfiction books, no network calls.
What it does
- Search 5904 books by title or author
- Return book metadata: title, author, rating, summary, link
- Generate markdown suggestions for knowledge base
Installation
clawhub install find-book
Usage
const FindBookSkill = require('find-book');
const skill = new FindBookSkill();
const result = skill.search('Atomic Habits');
Data
- Source: Heardly database
- Format: Local JSON cache
- Books: 5904 nonfiction titles
- Network: Zero external calls
- Cost: Free
License
MIT
Usage Guidance
This package appears to do exactly what it claims: local search over an included JSON of nonfiction books and generation of markdown snippets. Before installing, consider these checks: 1) Inspect SKILL.md for hidden control characters (the scanner flagged unicode-control-chars). 2) Verify the books.json provenance and licensing if you care about copyrighted content or data accuracy (the package claims 'Heardly' as source). 3) Note the metadata version mismatch (package files show v1.0.16 while registry lists v1.0.18) — confirm you have the intended release. 4) Run the included tests in a sandbox to confirm behavior and ensure the skill does not cause your agent to write automated changes to your knowledge files unless you intend that. If you plan to allow autonomous agent invocation, remember the skill can be called by the agent to produce text that the agent may choose to store elsewhere — review agent write/commit policies accordingly.
Capability Analysis
Type: OpenClaw Skill
Name: find-book
Version: 1.0.18
The find-book skill is a legitimate local search tool for a nonfiction book database. The code (index.js) performs fuzzy matching against a local JSON file and generates markdown snippets for the agent's internal knowledge base without any network calls, external dependencies, or dangerous execution sinks like eval or exec.
Capability Assessment
Purpose & Capability
Name/description claim a local search over 5904 nonfiction books; the package includes data/books.json and index.js implements local search, formatting, and suggestion generation. No unrelated credentials, binaries, or services are required. Minor metadata mismatch: package/_meta.json show version 1.0.16 while registry metadata lists 1.0.18.
Instruction Scope
SKILL.md and README instruct local usage and show example code; runtime instructions do not ask the agent to read unrelated system files or env vars. A static scan flagged 'unicode-control-chars' inside SKILL.md (possible hidden characters or obfuscation) — the runtime code does not rely on those, but the presence of hidden control characters in documentation is worth reviewing.
Install Mechanism
No install spec (instruction-only) and all code/data are bundled in the package. No remote downloads or install-time network calls are declared, reducing install-time risk. The large local data blob (data/books.json) is included in the package.
Credentials
The skill requires no environment variables, credentials, or special config paths, and the code does not access process.env or other external secrets.
Persistence & Privilege
always is false and user-invocable is true. The skill does not modify other skills or global agent settings; it only returns data/suggestions for the agent to consume.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install find-book - After installation, invoke the skill by name or use
/find-book - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.18
Fix version consistency, remove all control characters from SKILL.md
v1.0.17
Republish under heardlyapp account
v1.0.16
Remove external URLs and image references, pure local data only
v1.0.15
Fix: remove scrape script reference, rename goodreads_rating to rating, clean unicode control chars
v1.0.14
Stable release: Clean minimal version with 5904 books
v1.0.13
Force refresh: Clean minimal version with 5904 books, no warnings
v1.0.12
Clean release: Remove all documentation that triggers warnings, keep only core book search functionality with 5904 books
v1.0.11
Remove installation scripts and command handlers - keep only core find-book functionality (local book search + markdown suggestions)
v1.0.10
Add install-agent.sh - one-click auto-configuration for Agent, no manual setup needed
v1.0.9
Add SECURITY_AUDIT.md (passes all vetting), add setup-agent.sh for one-command Agent configuration
v1.0.8
Add agent-command-handler.js - enables 'install find-book' shorthand without clawhub prefix
v1.0.7
Add AGENT_SETUP.md for auto-install configuration, enable users to say '帮我安装 find-book 技能' in chat
v1.0.6
Real user experience: Show full summary and Heardly link, auto-generate specific SOUL/MEMORY/SKILL content with measurable skill improvements (+30%, +40%, etc)
v1.0.5
Enhanced UX: Display complete book details (title, author, rating, summary, link), explain SOUL/MEMORY/SKILL integration benefits, guide users through knowledge base upgrade
v1.0.4
Add INTEGRATION.md and EXAMPLES.md with usage patterns and auto-trigger examples
v1.0.3
Remove unicode control characters, add DATA_SOURCE.md explaining data origin and compliance
v1.0.2
Clean documentation, clarify data source (Heardly local cache), confirm no network calls, remove misleading files
v1.0.1
Fix: use Heardly database (5904 books), remove Goodreads scraper, fix data mapping bugs
v1.0.0
Initial release of the find-book skill.
- Instantly finds nonfiction books and provides Goodreads ratings, summaries, and key concepts.
- Suggests specific insights to add to agent SOUL, MEMORY, and SKILL files.
- Handles queries by book title, author, or concept during conversation.
- Includes links to Heardly for full book content.
- Uses a monthly-updated Goodreads-sourced dataset of 5000+ nonfiction books, cached locally.
- Integrates seamlessly with agent prompts and knowledge base workflows.
Metadata
Frequently Asked Questions
What is Find Book?
Instantly find nonfiction books with Goodreads ratings, summaries, key concepts, and AI suggestions for enhancing your agent's knowledge files. It is an AI Agent Skill for Claude Code / OpenClaw, with 177 downloads so far.
How do I install Find Book?
Run "/install find-book" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Find Book free?
Yes, Find Book is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Find Book support?
Find Book is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Find Book?
It is built and maintained by heardlyapp (@heardlyapp); the current version is v1.0.18.
More Skills