# gitbook-notion

Скилл gitbook-notion ведёт документацию в GitBook и Notion руками агента: синхронизация с Git, экспорт, импорт и аналитика через API обеих платформ.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 1 установка · ★ 1931 у репозитория
- Автор: babysitter-sdk
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/a5c-ai/babysitter/tree/HEAD/library/specializations/technical-documentation/skills/gitbook-notion/SKILL.md
- Обновлён: 2026-09-16
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/gitbook-notion

## Что делает

Скилл закрывает две платформы хостинга документации сразу: GitBook и Notion. Агент перечисляет пространства GitBook, читает и обновляет страницы, создаёт новые, тянет контент из Git-репозитория, выгружает и заливает материалы, настраивает вебхуки и забирает аналитику. Для Notion — работа с базой документации: фильтр по статусу, сортировка по дате правки, сборка страницы из markdown.

Запуск описывается полями `platform` (`gitbook` или `notion`), `action` (`sync`, `export`, `import`, `analytics`), `spaceId`, `sourcePath` и `outputPath`. Внутри — готовые классы на `gitbook-api` и `@notionhq/client`, конфиг `.gitbook.yaml` с деревом `SUMMARY.md` и workflow GitHub Actions на `gitbook/github-action-sync@v1`, который гонит `docs/**` в пространство по пушу в `main`.

Токен платформы уходит в конструктор клиента, а в CI его кладут в секреты репозитория (`secrets.GITBOOK_TOKEN`). Нет токена — ни один запрос не уйдёт, так что доступ к API придётся выдать до первого запуска.

## Требования
- Работает с: Notion

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add a5c-ai/babysitter --skill gitbook-notion -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/gitbook-notion/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/gitbook-notion/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add a5c-ai/babysitter --skill gitbook-notion -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/gitbook-notion/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add a5c-ai/babysitter --skill gitbook-notion -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/gitbook-notion/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install a5c-ai/babysitter library/specializations/technical-documentation/skills/gitbook-notion
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/gitbook-notion/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add a5c-ai/babysitter --skill gitbook-notion -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/a5c-ai/babysitter --path library/specializations/technical-documentation/skills/gitbook-notion
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/gitbook-notion/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add a5c-ai/babysitter --skill gitbook-notion -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/a5c-ai/babysitter/tree/HEAD/library/specializations/technical-documentation/skills/gitbook-notion/SKILL.md

## Когда брать
- выгрузить опубликованные страницы Notion в markdown-файлы
- держать пространство GitBook в такт с пушами в `docs/`
- собрать дерево `SUMMARY.md` для нового пространства
- забрать статистику просмотров пространства GitBook
- перелить контент из Notion в GitBook без ручного копирования

## Примеры запросов агенту
- Синхронизируй `./docs` с пространством GitBook `abc123`
- Выгрузи опубликованные страницы из базы Notion `abc123` в `./export`
- Покажи аналитику пространства GitBook `abc123` за период `30d`

## Похожие
- [notion-knowledge-capture](https://affpapa.org/nevibecode/skills/notion-knowledge-capture-2.md) — скилл · 612 установок
- [notion-research-documentation](https://affpapa.org/nevibecode/skills/notion-research-documentation-2.md) — скилл · 390 установок
- [notion_integration](https://affpapa.org/nevibecode/skills/notion-integration.md) — скилл · 1 установка
- [notion](https://affpapa.org/nevibecode/plugins/notion-notion.md) — плагин · ★ 8052 у репозитория
- [notion-api](https://affpapa.org/nevibecode/skills/notion-api.md) — скилл · 106200 установок
- [notion-sdk](https://affpapa.org/nevibecode/skills/notion-sdk.md) — скилл · 133 установки

Из того же набора: [a5c-ai/babysitter](https://affpapa.org/nevibecode/by/a5c-ai/babysitter.md) — 37 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
