# confluence-to-markdown

Внутренний модуль, который забирает страницу Confluence и отдаёт её содержимое в Markdown. Работает в связке с командами /bedrock:learn и /bedrock:sync.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · ★ 108
- Автор: iurykrieger
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/iurykrieger/claude-bedrock/tree/HEAD/skills/confluence-to-markdown/SKILL.md
- Обновлён: 2026-05-05
- HTML: https://affpapa.org/nevibecode/skills/confluence-to-markdown

## Что делает

Скилл принимает ссылку на страницу Confluence, разбирает её и достаёт из адреса базовый домен и числовой ID страницы. Дальше он пробует три способа по очереди: сначала Atlassian MCP, если тот установлен и прошёл авторизацию, затем REST API Confluence с Basic Auth, а в самом конце — вытаскивание содержимого из DOM через Claude in Chrome.

Для API нужны переменные окружения `CONFLUENCE_API_TOKEN` и `CONFLUENCE_USER_EMAIL`: из них собирается заголовок Basic Auth. Если хотя бы одной нет, скилл уходит на браузерный слой. Браузерный вариант опирается на `scripts/extract.js` рядом с папкой скилла — без этого файла третий слой не сработает.

Ответ 403 или 404 останавливает работу: правами страницы или неверным ID ничего не обойти. XHTML из storage-формата переводится в Markdown по таблице правил — заголовки, списки, таблицы, блоки кода. Макросы с текстом разворачиваются, картинки и вложения пропускаются. Вызывать скилл вручную не предполагается.

## Требования
- Работает с: Confluence, Chrome, Atlassian

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add iurykrieger/claude-bedrock --skill confluence-to-markdown -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add iurykrieger/claude-bedrock --skill confluence-to-markdown -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add iurykrieger/claude-bedrock --skill confluence-to-markdown -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install iurykrieger/claude-bedrock confluence-to-markdown
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add iurykrieger/claude-bedrock --skill confluence-to-markdown -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/iurykrieger/claude-bedrock --path skills/confluence-to-markdown
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add iurykrieger/claude-bedrock --skill confluence-to-markdown -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/iurykrieger/claude-bedrock/tree/HEAD/skills/confluence-to-markdown/SKILL.md

## Когда брать
- забрать страницу Confluence и получить её в Markdown
- вытащить содержимое через Atlassian MCP без ручного копирования
- подтянуть документацию из Confluence в проект по REST API
- достать страницу через браузер, когда API недоступен
- перевести storage-формат Confluence в читаемый Markdown

## Примеры запросов агенту
- Забери страницу Confluence по ссылке и верни её в Markdown
- Стяни содержимое страницы через Atlassian MCP
- Если MCP не отвечает, попробуй REST API с токеном

## Похожие
- [grill-with-docs](https://affpapa.org/nevibecode/skills/grill-with-docs.md) — скилл · 1219756 установок
- [skill-creator](https://affpapa.org/nevibecode/skills/skill-creator.md) — скилл · 414180 установок
- [setup-matt-pocock-skills](https://affpapa.org/nevibecode/skills/setup-matt-pocock-skills.md) — скилл · 1052851 установка
- [handoff](https://affpapa.org/nevibecode/skills/handoff.md) — скилл · 1038491 установка
- [triage](https://affpapa.org/nevibecode/skills/triage.md) — скилл · 990453 установки
- [domain-modeling](https://affpapa.org/nevibecode/skills/domain-modeling.md) — скилл · 876391 установка

Из того же набора: [iurykrieger/claude-bedrock](https://affpapa.org/nevibecode/by/iurykrieger/claude-bedrock.md) — 2 карточки

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

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