How do I install the Bookstack skill?

Run npx skillmds@latest add dvcrn/bookstack-2 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Bookstack safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts, makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Bookstack?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Bookstack free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Bookstack?

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Bookstack by dvcrn — Agent Skill

Name: Bookstack
Rating: 4.5 (4 reviews)
Author: dvcrn

Bookstack

BookStack Wiki & Documentation API integration. Manage your knowledge base programmatically: create, read, update, and delete books, chapters, pages, and shelves. Full-text search across all content. Use this skill whenever the user mentions BookStack, wiki pages, knowledge base, documentation pages, or wants to publish, update, or search content on a BookStack instance -- even if they just say 'update the docs' or 'check the wiki' without naming BookStack explicitly. Also use when syncing or automating documentation workflows between systems.

dvcrn Updated Sep 9, 2026 32 repo stars

File contents

BookStack API Skill

Interact with a BookStack wiki through its REST API using the bundled Python script. No external dependencies beyond Python 3 standard library.

Configuration

Credentials live in ~/.clawdbot/clawdbot.json under the bookstack skill entry:

{
  "skills": {
    "entries": {
      "bookstack": {
        "env": {
          "BOOKSTACK_URL": "https://your-bookstack.example.com",
          "BOOKSTACK_TOKEN_ID": "your-token-id",
          "BOOKSTACK_TOKEN_SECRET": "your-token-secret"
        }
      }
    }
  }
}

Generate a token from BookStack: Profile > API Tokens > Create Token. The user's role needs the "Access System API" permission enabled.

Usage

All commands follow the pattern:

python3 scripts/bookstack.py <command> [args] [options]

Pass the env vars from the config above when executing.

Quick Reference

Action	Command
Search	`search "query" [--type page\|book\|chapter]`
List pages	`list_pages [--count N]`
Read page	`get_page <id> [--content\|--markdown]`
Create page	`create_page --book-id <id> --name "Title" --html "<p>content</p>"`
Update page	`update_page <id> --html "<p>new content</p>"`
Delete page	`delete_page <id>`

The same CRUD pattern applies to books, chapters, and shelves. For the full command list with all flags and options, see references/api-commands.md.

Important Notes

Cloudflare protection: The script sends a User-Agent header because BookStack instances behind Cloudflare reject requests without one (HTTP 403). If you get a 403, this is likely why.
Content formats: Pages accept HTML by default. Use --markdown for Markdown input. When reading, get_page --content returns HTML, --markdown returns Markdown.
Large HTML updates: For big page updates, prepare the HTML in a temp file and read it into the API call programmatically, rather than passing it inline on the command line.

---name: bookstack-2description: BookStack Wiki & Documentation API integration. Manage your knowledge base programmatically: create, read, update, and delete books, chapters, pages, and shelves. Full-text search across all content. Use this skill whenever the user mentions BookStack, wiki pages, knowledge base, documentation pages, or wants to publish, update, or search content on a BookStack instance -- even if they just say 'update the docs' or 'check the wiki' without naming BookStack explicitly. Also use when syncing or automating documentation workflows between systems.--- # BookStack API Skill Interact with a BookStack wiki through its REST API using the bundled Python script. No external dependencies beyond Python 3 standard library. ## Configuration Credentials live in `~/.clawdbot/clawdbot.json` under the `bookstack` skill entry: ```json { "skills": { "entries": { "bookstack": { "env": { "BOOKSTACK_URL": "https://your-bookstack.example.com", "BOOKSTACK_TOKEN_ID": "your-token-id", "BOOKSTACK_TOKEN_SECRET": "your-token-secret" } } } } } ``` Generate a token from BookStack: Profile > API Tokens > Create Token. The user's role needs the **"Access System API"** permission enabled. ## Usage All commands follow the pattern: ``` python3 scripts/bookstack.py <command> [args] [options] ``` Pass the env vars from the config above when executing. ### Quick Reference | Action | Command | |--------|---------| | Search | `search "query" [--type page\|book\|chapter]` | | List pages | `list_pages [--count N]` | | Read page | `get_page <id> [--content\|--markdown]` | | Create page | `create_page --book-id <id> --name "Title" --html "<p>content</p>"` | | Update page | `update_page <id> --html "<p>new content</p>"` | | Delete page | `delete_page <id>` | The same CRUD pattern applies to `books`, `chapters`, and `shelves`. For the full command list with all flags and options, see [references/api-commands.md](references/api-commands.md). ## Important Notes - **Cloudflare protection**: The script sends a `User-Agent` header because BookStack instances behind Cloudflare reject requests without one (HTTP 403). If you get a 403, this is likely why. - **Content formats**: Pages accept HTML by default. Use `--markdown` for Markdown input. When reading, `get_page --content` returns HTML, `--markdown` returns Markdown. - **Large HTML updates**: For big page updates, prepare the HTML in a temp file and read it into the API call programmatically, rather than passing it inline on the command line.

Frequently asked questions