Przejdź do treści
Biblioteka skilli
Nauka i badania · Research

books

/books

Wyszukuje cytowalne książki do pytań badawczych: wydania po ISBN, pełne teksty z domeny publicznej, treści techniczne O'Reilly, własną bibliotekę (Kindle, Apple Books, Calibre, Zotero) i cyfrowe biblioteki publiczne.

Repozytorium
ailly ↗
Licencja
MIT
Ostatnia zmiana repozytorium
15.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
17
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 15.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Wyszukuje cytowalne książki do pytań badawczych: wydania po ISBN, pełne teksty z domeny publicznej, treści techniczne O'Reilly, własną bibliotekę (Kindle, Apple Books, Calibre, Zotero) i cyfrowe biblioteki publiczne.

Wyzwalacze z opisu

Reilly), the user
Oryginalny opis (EN)

Use when a research question targets a citable book — ISBN-keyed editions, public-domain full text, technical reference content (O'Reilly), the user's own library (Kindle, Apple Books, Calibre, Zotero), or aggregated public-domain digital libraries. Applies every time a research question targets books.

Jak działa

  1. Overview
  2. When to use / When NOT to use
  3. Query expansion (Jeopardy! search)
  4. Capability routing
  5. Output format
  6. Common mistakes
  7. Composes With
Sekcje z nagłówków SKILL.md, w oryginale · 105 linii, 1 164 słów
Podgląd SKILL.md
---
name: books
description: Use when a research question targets a citable book — ISBN-keyed editions, public-domain full text, technical reference content (O'Reilly), the user's own library (Kindle, Apple Books, Calibre, Zotero), or aggregated public-domain digital libraries. Applies every time a research question targets books.
---

# Books

## Overview

Per-query research against the configured books capability contract. Pick the **capability** the question needs (ISBN lookup, table-of-contents, library search, full-text retrieval), dispatch to it, write the result with IEEE citations. The transport (MCP or HTTP) is the wiring's concern, not this skill's. Setup, key rotation, and re-verification belong in [the books setup reference](../using-research/references/configuring/books.md); this skill consumes the contract that skill publishes.

## When to use / When NOT to use

**Use** for:

- Citable book content: edition resolution, full-text retrieval, table-of-contents fetch, table-of-contents+chapter selection.
- The user's own library (Kindle, Apple Books, Calibre, Zotero, Ebook-MCP) when configured.
- Technical book and course content via O'Reilly Learning when access is configured.
- Reading-community signal (reviews, comparable titles) via Hardcover.

**When NOT to use:**

- To configure books sources, install an MCP, rotate a key, or add a new source. Those belong in [the books setup reference](../using-research/references/configuring/books.md).
- For language reference, library documentation, RFCs, or public web search — use `research:public`.
- For internal documents (Slack, Confluence, Linear, Notion) — use `research:internal`.
- For domain-model questions (entities, bounded contexts, ubiquitous language) — use `research:domain`.
- For academic papers, preprints, DOIs, citation graphs — use `research:papers`.

## Query expansion (Jeopardy! search)

Before dispatching to a capability, expand the question into 3-5 variants (see [`research/references/jeopardy.md`](../../references/jeopardy.md) for the general technique). Books-specific axes:

- **ISBN variants** — ISBN-10 and ISBN-13; edition-specific vs work-level (Open Library `/works/{olid}` vs `/books/{olid}`).
- **Title-and-author variants** — full title, subtitle, abbreviated title, common short forms (`DDD` for *Domain-Driven Design*); first-author-only vs. all-authors.
- **Edition-disambiguation variants** — original-edition year and publisher, anniversary or annotated editions, paperback vs. hardcover, translated editions.
- **Topic-and-keyword variants** — when the user does not know the title; pair the domain keyword with the publisher's known imprint (e.g., O'Reilly for Linux administration).
- **Author-name normalization** — anglicized vs. native script, initials vs. full first name, common pen-name aliases.

Run the variants in the order that the routing table below dictates. Union the result sets before deciding which capability has the highest-quality hit.

## Capability routing

Capabilities are named in the contract published by [the books setup reference](../using-research/references/configuring/books.md). The routing table maps question type to the capability that answers it.

| Question intent | Primary capability | Reference |
|---|---|---|
| "What is the canonical ISBN-13 for X" | ISBN→edition lookup | [`references/open-library.md`](references/open-library.md) |
| "All editions of X" | Title+author search | [`references/open-library.md`](references/open-library.md) |
| "Quote a passage from a public-domain text" | Open full text | [`references/gutendex.md`](references/gutendex.md) |
| "Older or out-of-print scanned book" | Open full text via Internet Archive | [`references/internet-archive.md`](references/internet-archive.md) |
| "Table of contents for a recent commercial book" | Table-of-contents fetch | [`references/google-books.md`](references/google-books.md) |
| Technical / hands-on / career-skill query | O'Reilly library search | [`references/oreilly.md`](references/oreilly.md) |
| "Find a passage from a book in my library" | Kindle library search | [`references/kindle.md`](references/kindle.md) |
| "Find an EPUB I imported into Apple Books" | Apple Books library search | [`references/claude-reader.md`](references/claude-reader.md) |
| "Search my Calibre library" | Calibre full-text search | [`references/calibre.md`](references/calibre.md) |
| "Books I have saved or annotated in Zotero" | Zotero library lookup | [`references/zotero.md`](references/zotero.md) |
| Cross-corpus public-domain sweep | Aggregated public-domain search | [`references/alexandria.md`](references/alexandria.md) |
| "Local EPUB / PDF directory semantic search" | Ebook-MCP / bookreader-mcp | [`references/ebook-mcp.md`](references/ebook-mcp.md) |
| "What do other readers say about this book" | Hardcover reviews | [`references/hardcover.md`](references/hardcover.md) |
| Academic library holding confirmation | HathiTrust bibliographic API | [`references/hathitrust.md`](references/hathitrust.md) |
| Primary-source historical document | Library of Congress | [`references/library-of-congress.md`](references/library-of-congress.md) |

### Routing heuristic

The routing table is the lookup. The heuristic below is what to apply when the question does not name a source:

- **Technical or career-skill query** → O'Reilly first, then Google Books for TOC, then Open Library for edition disambiguation.
- **Classic or out-of-copyright text** → Gutendex or Internet Archive for the full text, with Open Library as the bibliographic anchor.
- **Recent commercial nonfiction** → Google Books for TOC, Open Library for edition data, Hardcover for reader signal.
- **Primary-source historical document** → Library of Congress or Internet Archive.
- **User's own corpus** → in priority order according to what is configured: Kindle, Apple Books (Claude Reader), Calibre, Zotero, Ebook-MCP.
- **Source unknown / broadest sweep** → Alexandria for aggregated cross-corpus discovery, then narrow to the targeted per-source capability for the strongest hits.

For conditional capabilities that the contract marks Not-Available (no MCP configured, key missing, SSO expired), accept the typed Not-Available result as a routing signal and continue with the next capability in the heuristic. Do not pretend the source is unreachable as an error; the practice skill degrades gracefully to the public-free stack.

## Output format

Write findings to `.ailly/research/YYYY-MM-DD-A-<topic>/books.md`, unless the caller provides a task-scoped research folder such as `.ailly/developer/<session-slug>/research/`; in that case write `books.md` there. Cite per the loose IEEE style in [`research/references/citations.md`](../../references/citations.md). One consolidated `books.md` per session topic (per Decision 6: no per-source split, no cache).

```
# Books: <question>

## Findings
<narrative: synthesized answer with inline citations [N]>

## Sources
[1] Author/Org. "Title." Date. [Online]. Available: <URL>
[2] Author/Org. "Title." Date. [Online]. Available: <URL>
```

Excerpts only; do not stage cached PDFs or full bodies. For passages from copyrighted or licensed sources (O'Reilly, Kindle, Apple Books, Calibre, HathiTrust gated), quote within the session for the user's own work and cite-and-link; do not stage to public artifacts.

## Common mistakes

- **Skipping query expansion.** A single phrasing often misses the canonical ISBN or the edition the user actually owns. Always expand first.
- **Mixing capabilities.** Calling Gutendex for an in-copyright recent technical book; calling Google Books for a 19th-century classic. Each capability has a content focus; the routing table is the lookup.
- **Quoting from non-quotable sources.** HathiTrust gated full text is non-consumptive; Hardcover reviews are user-generated under platform terms; O'Reilly content is subscription-licensed; Kindle and Apple Books content is personal-use licensed. Cite-and-link instead.
- **Ignoring typed Not-Available.** A conditional capability returning Not-Available is a routing signal, not a failure. Continue with the next capability in the heuristic.
- **Re-teaching the wiring.** A "first, make sure you have configured O'Reilly access" preface is wiring leakage. The wiring SKILL owns setup; this skill consumes the contract. If a preface is unavoidable, the contract is incomplete — widen it in [the books setup reference](../using-research/references/configuring/books.md).
- **Routing the user's own corpus to public sources first.** When the user asks about a passage from a book they own, the priority order is their library (Kindle, Apple Books, Calibre, Zotero, Ebook-MCP) **before** Open Library or Internet Archive.
- **Treating Alexandria as a replacement for per-source capabilities.** Alexandria is a supplement for cross-corpus sweeps; for targeted ISBN lookup, edition disambiguation, or public-domain full-text retrieval, the per-source capability gives richer query shapes and licensing metadata.

## Composes With

- **the books setup reference** (`research:using-research`, `references/configuring/books.md`) — the wiring partner. Publishes the contract this skill consumes.
- **`research:papers`** — sibling practice skill for academic papers.
- **`research/references/jeopardy.md`** — query expansion technique.
- **`research/references/citations.md`** — IEEE citation format.
Pliki w paczce (17)
  • SKILL.md 9 KB
  • references/alexandria.md 3 KB
  • references/calibre.md 2 KB
  • references/claude-reader.md 2 KB
  • references/ebook-mcp.md 2 KB
  • references/etiquette.md 4 KB
  • references/google-books.md 3 KB
  • references/gutendex.md 3 KB
  • references/hardcover.md 2 KB
  • references/hathitrust.md 2 KB
  • references/internet-archive.md 3 KB
  • references/kindle.md 3 KB
  • references/library-of-congress.md 2 KB
  • references/open-library.md 2 KB
  • references/oreilly.md 3 KB
  • references/out-of-scope.md 4 KB
  • references/zotero.md 2 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · davidsouther/ailly100MIT
giltotherescue/slashbooks100Apache-2.0

Migawka bazy z 13.11.2026 · wersja paczki d16c6c3699cf (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100books-calibre
    Obsługuje Calibre jako zaplecze danych dla skilla books-library, gdy ten wybiera Calibre jako źródło biblioteki książek.
  • 95pilot-service-agents-books
    Wyszukuje książki w katalogach Project Gutenberg (Gutendex) i Open Library: teksty z domeny publicznej oraz rekordy po tytule, autorze lub ISBN.
  • 90books-library
    Przeszukuje i analizuje książki z biblioteki Calibre lub z eksportu Goodreads i rekomenduje kolejne lektury.
  • 100sci-zotero
    Synchronizuje bibliotekę Zotero, dodaje cytowania po DOI, ISBN lub PMID i zarządza plikami PDF.
  • 100book-capture
    Przechwytuje strony książek z Kindle na Macu, Apple Books, Kindle Cloud Reader, plików PDF lub zdjęć papierowej książki, wykonuje OCR i generuje ustrukturyzowany markdown dla Obsidiana.
  • 100zotero-cli
    Odczytuje i zapisuje bibliotekę Zotero z terminala: szuka artykułów, czyta pełne teksty, zarządza kolekcjami i eksportuje bibliografie.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.