| name | discover-books |
| description | Discover new books using OpenLibrary API with Federated Taxonomy integration. Recommends books based on subjects, authors, and HMT bridge attributes. Can be invoked via /dogpile books.
|
| triggers | ["discover books","find new books","book recommendations","similar books","books like","dogpile books"] |
| allowed-tools | ["Bash","Python"] |
| metadata | {"short-description":"Discover books via OpenLibrary + Taxonomy"} |
Discover Books Skill
Find new books for Horus based on preferences, taxonomy bridge attributes, and OpenLibrary.
Quick Start
cd .pi/skills/discover-books
./run.sh similar "Dune"
./run.sh by-author "Frank Herbert"
./run.sh search-subject "science fiction"
./run.sh bridge Resilience
./run.sh trending
./run.sh fresh
./run.sh check
Discovery Services
| Service | API | Use For |
|---|
| OpenLibrary | Free (no key) | Book search, authors, subjects, trending |
No API key required. Just respect rate limits (100 req/5 min).
Commands
Similar Books
./run.sh similar "<book>" [--limit 10] [--json]
Find books similar to a given book via shared subjects.
Books by Author
./run.sh by-author "<name>" [--limit 10] [--json]
Get all books by a specific author.
Search by Subject
./run.sh search-subject "<subject>" [--limit 10] [--json]
Search books by subject or genre (e.g., "science fiction", "horror", "philosophy").
Search by Bridge
./run.sh bridge <attribute> [--limit 10] [--json]
Search for books matching an HMT bridge attribute:
| Bridge | Book Subjects |
|---|
| Precision | hard science fiction, technical thriller, mathematics, philosophy |
| Resilience | epic fantasy, military fiction, adventure, survival, heroic |
| Fragility | literary fiction, poetry, memoir, psychological, coming of age |
| Corruption | dark fantasy, horror, grimdark, cosmic horror, dystopian |
| Loyalty | historical fiction, saga, mythology, family saga, war |
| Stealth | mystery, espionage, thriller, detective, conspiracy |
Trending Books
./run.sh trending [--limit 10] [--json]
Get popular/trending books (by edition count).
Fresh Releases
./run.sh fresh [--limit 10] [--json]
Get recently published books.
Recommendations
./run.sh recommendations [--limit 10] [--json]
Get personalized recommendations based on consume-book history.
Check API
./run.sh check
Test connectivity to OpenLibrary API.
Integration with /dogpile
This skill can be invoked via /dogpile books:
/dogpile books "epic fantasy similar to Dune"
./run.sh similar "Dune"
./run.sh bridge Resilience
Taxonomy Integration
All JSON output includes taxonomy metadata for cross-collection graph traversal:
{
"results": [...],
"taxonomy": {
"bridge_tags": ["Resilience", "Precision"],
"collection_tags": {
"domain": "Imperium",
"function": "Revelation"
},
"confidence": 0.75,
"worth_remembering": true
}
}
This enables queries like:
- "Find books with same bridge as Siege of Terra lore"
- "Books matching Fragility theme"
Configuration
No environment variables required. OpenLibrary is free and open.
Rate Limits
| Service | Limit | Implementation |
|---|
| OpenLibrary | ~100 req/5 min | 0.5s minimum interval |
Example Horus Queries
./run.sh similar "Dune" --limit 10
./run.sh by-author "Frank Herbert"
./run.sh search-subject "cosmic horror"
./run.sh bridge Resilience
./run.sh bridge Corruption
./run.sh trending
./run.sh fresh --json
Output Formats
All commands support --json for agent-parseable output with taxonomy:
{
"results": [
{"key": "/works/OL45804W", "title": "Dune", "authors": "Frank Herbert", "year": "1965", "subjects": ["science fiction", "space opera"]},
{"key": "/works/OL45810W", "title": "Children of Dune", "authors": "Frank Herbert", "year": "1976", "subjects": ["science fiction"]}
],
"count": 2,
Pipeline Integration
discover-books → ingest-book → consume-book → review-story
↓ ↓ ↓ ↓
Find books Download via Read with Analyze
Readarr context themes