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