A collection of Agent Skills for working with GitBook.
Each skill is a SKILL.md file you can install into AI coding agents like Claude Code, Cursor, and
Codex. It teaches the agent how to handle one part of GitBook (writing content, managing a site,
using the CLI, building API references) so you don't have to paste the same instructions into every
session. The agent loads a skill when it's relevant.
- gitbook-write: writing GitBook content as files (custom blocks, page frontmatter,
SUMMARY.md, variables, Mermaid diagrams, cross-space links, thebuiltin:openapipage tree). - gitbook-site: creating and maintaining whole GitBook sites (structure design, repo scaffolding, the GitBook REST API, branding, the Git Sync handoff). Bundles an example-site reference.
- gitbook-cli: using the
@gitbook/clicommand (auth, scaffolding, developing, publishing integrations, pushing OpenAPI specs, including from CI/CD). - gitbook-openapi: authoring OpenAPI/Swagger references (
x-*extensions, the "Test it" runner, page structure, operation lifecycle, CI/CD publishing).
Skills install with the skills CLI. It detects which agents you have installed (Claude Code, Cursor, Codex) and links the skills into each one.
# Install every skill in this repo
npx skills add gitbookio/skills --all
# Install a specific skill
npx skills add gitbookio/skills --skill gitbook-write
npx skills add gitbookio/skills --skill gitbook-site
npx skills add gitbookio/skills --skill gitbook-cli
npx skills add gitbookio/skills --skill gitbook-openapi
# Browse the skills in this repo, then pick interactively
npx skills add gitbookio/skills --list
npx skills add gitbookio/skillsSkills install at project scope by default, so they're committed with your repo and shared with your team. Once installed, just ask your agent to work on your GitBook content and it picks the right one.
Manage installed skills with npx skills list, npx skills update, and npx skills remove.