bookstack

Manages a self-hosted wiki end to end, creating and editing books, chapters, pages and shelves, running full-text searches and accepting either markup or rich content for page bodies. The command surface is broad and uniform, which makes bulk documentation changes and cross-system syncing practical from a script. Setup needs three values in the environment: the instance address plus a token identifier and secret pair, all taken from an existing deployment, so there is no hosted fallback and the skill is inert without a reachable server. Delete operations are permanent and unguarded, and a token inherits its owner's permissions, so an administrator token hands over everything.

Use case: Bulk updating pages in a team wiki

BookStack is a self hosted wiki, and this skill drives it through a single python helper that knows how to talk to the instance. It covers the whole hierarchy, from shelves down to pages, plus a full text search, which makes it useful for documentation work that would otherwise be a long sequence of clicks. ## What it does - Lists, creates, updates and deletes books, chapters, pages and shelves. - Writes page bodies as either html or markdown, so generated documentation stays readable. - Searches the whole knowledge base by term. - Fetches a single page or a book by its numeric identifier. - Organizes content as chapters inside books, and books inside shelves. ## When it is the wrong choice Every call needs three pieces of connection data to exist first: the instance address, a token id and a token secret. That makes it unusable against a wiki you cannot mint tokens for. It is also a straight wrapper with no local cache, so a search heavy loop hits the instance on every call and is only as fast as the server is. Content is written through the same commands as reads, and deletion is included, which means the blast radius of a wrong identifier is a destroyed page rather than a failed read. Finally, it is a helper script rather than a general client, so anything it does not expose has to be done in the web interface. ```bash python3 scripts/bookstack.py list_books python3 scripts/bookstack.py search "Home Assistant" python3 scripts/bookstack.py get_page 123 ``` ## Working notes - Connection details live in three environment variables for the instance, the token id and the token secret. - Page bodies can be written as markdown, which keeps generated docs close to their source. - Reading a page before writing it is the cheapest way to confirm the identifier.