Agent skills
Add GitBook skills to AI coding assistants like Claude Code, Cursor, or Codex so they can work with GitBook pages, sites, and workflows
Setting up GitBook for the first time? Point your agent to Set up GitBook instead.
GitBook publishes a set of skills in the gitbook-skills repository. They teach AI coding assistants how to work with GitBook documentation: writing pages, configuring sites, OpenAPI references, change requests, and integrations. If you use Claude Code, Cursor, Codex, or another coding assistant, add the skills so your agent can use GitBook syntax, blocks, and configuration files correctly.
This fits well with Git Sync workflows — make changes in your repo, commit them, and your docs site updates automatically.
Add GitBook skills to your AI agent
Use this option when your AI coding assistant supports package-based skills.
Connect GitBook MCP
Skills that only edit files, such as write-docs, don’t need GitBook authentication. Skills that talk to GitBook — including configure-site, write-openapi, cr-create, and cr-review — should use the GitBook MCP connection, which signs in with OAuth in the browser.
A personal access token from your developer settings is only needed if you’re calling the REST API directly. cr-create and cr-review use the REST API, so they need a token. configure-site and write-openapi prefer MCP first, and fall back to a token when MCP isn’t connected.
Install GitBook skills
The skills live in the gitbook-skills repository. Run the following command to install them in your project:
Without both -y flags, the installer waits for input.
Add GitBook skills locally
Download GitBook’s skills if your assistant doesn’t support package-based skills.
Download GitBook skills
Install GitBook skills with npx -y skills add GitbookIO/gitbook-skills -y when your assistant supports it.
To copy the files to your project manually, get them from the gitbook-skills repository.
cr-create
Drive a GitBook docs review flow via the REST API — create a change request, push content, request review, and 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, and OAuth.
Using GitBook skills
FAQ
Last updated
Was this helpful?