majiayu000 Discover Books Skill
Find new books for Horus based on preferences, taxonomy bridge attributes, and OpenLibrary.
Quick Start
cd .pi/skills/discover-books
# Find similar books
./run.sh similar "Dune"
# Get books by author
./run.sh by-author "Frank Herbert"
# Search by subject/genre
./run.sh search-subject "science fiction"
# Search by bridge attribute
./run.sh bridge Resilience
# Trending/popular books
./run.sh trending
# New releases
./run.sh fresh
# Check API connectivity
./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:
# Via dogpile
/dogpile books "epic fantasy similar to Dune"
# Equivalent to
./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
# "What's similar to Dune?"
./run.sh similar "Dune" --limit 10
# "Books by Frank Herbert"
./run.sh by-author "Frank Herbert"
# "Find cosmic horror books"
./run.sh search-subject "cosmic horror"
# "Books for a resilience scene" (Resilience bridge)
./run.sh bridge Resilience
# "Dark fantasy for corruption scene"
./run.sh bridge Corruption
# "What's popular right now?"
./run.sh trending
# "New releases for discovery"
./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,
"taxonomy": {
"bridge_tags": ["Resilience", "Precision"],
"collection_tags": {"domain": "Imperium", "function": "Revelation"},
"confidence": 0.75,
"worth_remembering": true
}
}
Pipeline Integration
discover-books → ingest-book → consume-book → review-story
↓ ↓ ↓ ↓
Find books Download via Read with Analyze
Readarr context themes