Pilot Service Agents Books

Book search and catalogs — Project Gutenberg (Gutendex) and Open Library. Use this skill when: 1. Searching Project Gutenberg for public-domain texts 2. Look...

Security Scan

The skill's requirements and runtime instructions match its stated purpose (searching Project Gutenberg and Open Library via Pilot Protocol agents); nothing requested appears disproportionate or unrelated.

Purpose & Capability

The skill is a Pilot Protocol 'service agent' front-end for book catalogs and declares the need for pilotctl, a running Pilot Protocol daemon, and access to the overlay. Those requirements are coherent with the stated purpose of discovering and querying in-network agents.

Instruction Scope

SKILL.md only instructs the agent to use pilotctl to call /help, /data, and /summary on in-network agents and to read responses from the inbox. It does not instruct reading local files, environment variables, or transmitting arbitrary system data. Note: agent responses include an upstream_url field (resolved upstream URLs) — these are external links returned by the service agents and should be treated like any external link.

Install Mechanism

This is instruction-only with no install spec and no code files, so nothing is downloaded or written by the skill itself. Requiring pilotctl on PATH is reasonable for runtime interaction with the Pilot Protocol.

Credentials

The skill requests no environment variables or credentials. The declared requirements (pilotctl binary and a running daemon joined to network 9) are proportional to the stated networked-agent usage.

Persistence & Privilege

always:false and no install actions are requested. The skill does rely on a running Pilot Protocol daemon and network membership (network 9) but does not request elevated or persistent system-wide privileges beyond normal daemon operation.

Assessment

This skill appears to do what it says: it queries Pilot Protocol 'books' agents and returns metadata and links. Before installing: ensure you trust the Pilot Protocol daemon and network (joining network 9 exposes your node on that overlay), have pilotctl from a trusted source on PATH, and understand that agent responses may include external URLs (upstream_url) — treat those links cautiously and don't paste secrets into queries. If you don't already run the Pilot Protocol daemon or trust the network/agents listed, do not join the network or install the skill. If you want stronger assurance, verify the pilot-protocol and pilot-service-agents core skills' provenance and inspect any agent responses before following external links.

Book search and catalogs — Project Gutenberg (Gutendex) and Open Library.

All agents in this category follow the standard contract described in pilot-service-agents. Send /help to any agent to read its exact filter schema — the table below is a snapshot; the catalogue grows, so always verify with a fresh list-agents query.

Agents in this category (snapshot)

Hostname	Description
gutendex-books	Project Gutenberg search - free public-domain books
openlibrary-search	Open Library book search - titles, authors, ISBNs

What you can expect

• Open catalogs of downloadable / referenceable book metadata

What NOT to expect

• Full-text reading inside the agent response — it returns links and metadata

Commands (same pattern for every agent in the category)

# Read an agent's filter contract
pilotctl --json send-message <hostname> --data "/help"
pilotctl --json inbox

# Fetch structured data
pilotctl --json send-message <hostname> --data '/data {json filters}'
pilotctl --json inbox

# Natural-language summary (Gemini)
pilotctl --json send-message <hostname> --data '/summary {json filters}'
pilotctl --json inbox

Response shape

send-message returns an ACK envelope immediately ({"ack":"ACK TEXT N bytes", "bytes":N, "target":"<address>", "type":"text"}). The actual agent response arrives a few seconds later and is read with pilotctl --json inbox. Each inbox entry carries the agent's normalised envelope in its data field:

{
  "source": "<hostname>",
  "items":  [...],
  "count":  <int>,
  "total":  <int|null>,
  "page":   <int|null>,
  "next":   <cursor|null>,
  "truncated": <bool>,
  "upstream_url": "<resolved upstream URL>"
}

/help returns plain text. /summary returns a Gemini-generated prose string. Free-text queries also return Gemini prose.

Workflow Example

# 1. Fresh discovery — the catalogue grows, never hard-code
pilotctl --json send-message list-agents --data '/data {"category":"books","limit":20}'
pilotctl --json inbox

# 2. Read the contract of a specific agent
pilotctl --json send-message openlibrary-search --data '/help'
pilotctl --json inbox

# 3. Query it
pilotctl --json send-message openlibrary-search --data '/data {"q":"the great gatsby","limit":3}'
pilotctl --json inbox

Dependencies

Requires the pilot-protocol core skill, the pilot-service-agents skill (for the general discovery flow), pilotctl on PATH, and a running daemon joined to network 9.