GitBook Skills

A collection of skills for AI coding agents following the Agent Skills format. Available as a plugin for Claude Code, Cursor, OpenAI Codex, and Grok.

Install

npx skills add GitbookIO/gitbook-skills

Then select the ones you wish to install.

Running non-interactively (e.g. an AI agent installing on your behalf)? Use the -y flags to skip the interactive picker and install all skills — without them the installer hangs waiting for input:

npx -y skills add GitbookIO/gitbook-skills -y

Available Skills

Skill	Description
write-docs	Author and edit GitBook-flavored Markdown pages
configure-site	Create and configure GitBook sites end-to-end via the REST API
write-openapi	Author and publish OpenAPI reference docs in GitBook
cr-create	Drive a GitBook docs review flow via the REST API — create a change request, push content, request review, fix comments
cr-review	Review GitBook change requests via the REST API — discover CRs, summarize changes, comment, approve or request changes
build-integration	Build, develop, and publish GitBook integrations — custom blocks, ContentKit UI, events, OAuth

Example prompts

Once installed, just ask your agent in natural language. Here are a few things you can build:

Spin up a new documentation site from scratch

Create a new GitBook site for my product. Design the structure with a "Getting Started" section, a "Guides" section, and an "API Reference" section, scaffold the Git repo in monorepo layout, create the site and spaces via the API, and give me the Git Sync steps.

Uses configure-site to design the structure, create the site/sections/spaces via the REST API, and hand off the one manual Git Sync step.

Write and format your first pages

Write a "Getting Started" page for my docs with a quickstart stepper, a hint block calling out the prerequisites, and tabs showing install commands for npm, yarn, and pnpm.

Uses write-docs to author GitBook-flavored Markdown with blocks like steppers, hints, and tabs — no GitBook UI required.

Add an interactive API reference

Add an OpenAPI reference section to my site from this spec URL, wire up the interactive "Test it" runner, and add icons and code samples to the main operations.

Uses write-openapi to generate API reference pages, configure the "Test it" runner, and customize operations with GitBook x-* extensions.

Plugins

This repo serves as a plugin for multiple platforms:

• Claude Code — .claude-plugin/
• Cursor — .cursor-plugin/
• OpenAI Codex — .codex-plugin/
• Grok — .grok-plugin/

License

MIT