🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
BytesAgain β€Ί Skills β€Ί librarian companion
πŸ¦€ ClawHub

librarian companion

by @nonlinear

Conversational interface for semantic book search (companion skill for Librarian project)

Versionv1.0.1
Installs4
#legal
πŸ’‘ Examples

TOPIC wins (tiebreaker):

  • "Graeber debt finance" β†’ matches both "Debt.epub" + "finance" β†’ TOPIC: finance

    • BOOK only:

  • "Graeber hexagram 23" β†’ matches "Debt.epub" only β†’ BOOK: Debt.epub
  • "I Ching moving lines" β†’ matches "I Ching.epub" only β†’ BOOK: I Ching.epub

    • TOPIC only:

  • "chaos magick sigils" β†’ matches "chaos-magick" only β†’ TOPIC: chaos-magick
  • "mutual aid commons" β†’ matches "anarchy" only β†’ TOPIC: anarchy

    • CLARIFY (no match):

  • "philosophy" β†’ no match β†’ CLARIFY: "Search which topic or book?"
  • "systems" β†’ no match β†’ CLARIFY: "Need more context - which area?"

    • Scope Types

    1. Topic scope: --topic TOPIC_ID - Available topics: chaos-magick, finance, anarchy (check .topic-index.json)

    2. Book scope: --book FILENAME - Requires exact filename (e.g., "Condensed Chaos.epub") - Use fuzzy matching: "Condensed" β†’ "Condensed Chaos.epub"

    πŸ“‹ Tips & Best Practices

    "No metadata found"

  • Run index_library.py first
  • Check books/.topic-index.json exists

    • "No results" but book exists

  • Check topic ID matches (e.g., "chaos-magick" not "chaos magick")
  • Verify book is in correct topic folder
  • Try broader query terms

    • "System broken"

  • Check Python dependencies: pip3 list | grep sentence
  • Verify research.py syntax: python3 engine/scripts/research.py --help
  • Check FAISS index integrity

    • View on ClawHub
    TERMINAL
    clawhub install librarian

    πŸ§ͺ Use this skill with your agent

    Most visitors already have an agent. Pick your environment, install or copy the workflow, then run the smoke-test prompt above.

    Manus
    Task-oriented agent. Great for testing AI skills end-to-end.
    Try Manus β†’
    OpenClaw
    Local-first agent. Install skills via ClawHub CLI.
    Set up OpenClaw β†’
    Claude Code
    Anthropic's coding agent. Paste the prompt or SKILL.md into your session.
    Claude Code docs β†’
    Cursor
    AI-powered IDE. Use the smoke-test prompt in Cursor Agent.
    Open Cursor β†’
    Continue.dev
    Open-source AI code assistant. Add SKILL.md as a custom tool.
    Continue docs β†’
    Windsurf
    Agentic IDE by Codeium. Paste the prompt into Cascade.
    Try Windsurf β†’
    Cline
    VS Code extension for autonomous coding with MCP tools.
    Cline on GitHub β†’
    Copilot Workspace
    GitHub's AI dev environment. Suitable for code-generation skills.
    Copilot Workspace β†’

    πŸ” Can't find the right skill?

    Search 60,000+ AI agent skills β€” free, no login needed.

    Search Skills β†’