Skip to content
TakoAPI
Back to skills

librarian

by nonlinear

Search & Research
326Downloads reported by clawskills.sh
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

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

Description

What This Skill Does

A conversational interface for searching a personal book library using semantic embeddings. Ask questions in natural language and get back synthesized answers with page-level citations. Runs as a companion to the Librarian project via a three-layer architecture: AI skill, shell wrapper, and Python search engine.

Returns precise citations with page and paragraph numbers from local files instead of summarizing from memory or requiring a web search.

When to Use It

  • Finding what a specific author says about a topic across your library
  • Locating passages in a single book by concept or keyword
  • Getting cited answers from a topic folder of books
  • Cross-referencing ideas across multiple texts without opening each file
  • Querying a personal research archive by natural language

Example Workflow

INPUT

User asks: What does Graeber say about the origins of money?

AGENT
  1. 1

    Load .library-index.json and .topic-index.json metadata

  2. 2

    Match query against known book titles and topic IDs to infer scope

  3. 3

    Build shell command: ./librarian.sh "origins of money" topic finance 5

  4. 4

    Parse JSON results from Python search engine

  5. 5

    Synthesize answer and format citations with page numbers

OUTPUT

Paragraph summarizing Graeber's argument with inline citations like [Debt: The First 5000 Years, p.21, ¶2] and a sources list

Requirements

  • Librarian parent project installed (github.com/nonlinear/librarian)

Installation

clawhub install nonlinear/librarian

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links