gitbook-docs-expertlisted
Install: claude install-skill Ortus-Solutions/skills
# GitBook
A comprehensive guide for editing GitBook documentation in external environments like Cursor, Claude Code, or other text editors. This skill provides all the formatting syntax, configuration options, and best practices needed to create and maintain GitBook content outside the GitBook web interface.
### When to Use This Skill
Use this skill when working with GitBook documentation through:
* Git-synced repositories (GitHub, GitLab)
* Local markdown editors
* IDE integrations
* Command-line tools
* Any environment where you're editing GitBook content as files rather than through the GitBook UI
### Quick Reference
#### GitBook Content Structure
GitBook organizes content through pages, spaces, and collections:
* **Pages** are individual markdown files that make up your documentation
* **Spaces** are collections of pages organized into a documentation site
* **Collections** are groups of spaces
**File structure:**
```
/
.gitbook/
assets/ # GitBook-managed images and files
includes/ # Reusable content blocks
vars.yaml # Space-level variables
.gitbook.yaml # Configuration
README.md # Homepage
SUMMARY.md # Table of contents
getting-started/ # Section folder
installation.md
quickstart.md
api-reference/
authentication.md
endpoints.md
```
**Frontmatter fields:**
```markdown
---
description: Page description for SEO
icon: book-open
hidden: true
vars:
p