К основному содержанию
скилл CX Codex

confluence-assistant — скилл для Claude Code: что делает и установка

Скилл confluence-assistant учит агента работать с Confluence через Atlassian MCP. Помогает искать страницы поиском Rovo, создавать новые записи в разметке Markdown и обновлять документацию прямо из чата.

CC-BY-4.0 ★ 7 191 обновлён 2026-10-24

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add tech-leads-club/agent-skills --skill confluence-assistant -a claude-code
Открыть на GitHub

Что делает confluence-assistant

Скилл связывает Claude Code с рабочим пространством Confluence через Atlassian MCP. Ассистент сначала определяет Cloud ID или адрес сайта (https://example.atlassian.net/), проверяя контекст диалога или запрашивая их у пользователя. Затем он может искать статьи на естественном языке через вызов search, просматривать пространства и читать конкретные документы.

Для создания и правки страниц (createConfluencePage, updateConfluencePage) скилл требует исключительно разметку Markdown в поле body. Формат HTML запрещён. Инструмент различает типы идентификаторов: числовой pageId, числовой spaceId и строковый spaceKey.

Без настроенного MCP-сервера Atlassian скилл работать не будет. Для тикетов Jira или локальных файлов инструкция прямо запрещает его вызывать.

Какие задачи решает

  • найти документацию в Confluence через Rovo Search
  • создать страницу в пространстве с разметкой Markdown
  • обновить текст существующего документа и добавить разделы
  • просмотреть список страниц пространства по идентификатору
  • добавить комментарий к рабочей странице

Примеры запросов агенту

  • Найди в Confluence документацию по нашему API и добавь в неё новый раздел
  • Создай в пространстве TECH страницу с архитектурным решением ADR-001
  • Покажи список страниц в спейсе команды и найди инструкции по онбордингу

Как установить confluence-assistant

1Через Skills CLI (Vercel)

npx skills add tech-leads-club/agent-skills --skill confluence-assistant -a claude-code

2Вручную: положить файлы

~/.claude/skills/confluence-assistant/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/confluence-assistant/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о confluence-assistant

Как установить confluence-assistant в Claude Code?

Выполните в терминале команду npx skills add tech-leads-club/agent-skills --skill confluence-assistant -a claude-code. Также можно вручную сохранить файл по пути ~/.claude/skills/confluence-assistant/SKILL.md.

Что делает confluence-assistant?

Скилл даёт Claude Code инструкции для управления базой знаний Confluence через Atlassian MCP. Он находит нужные страницы поисковым запросом, запрашивает содержимое по ID или ARI и вносит правки в формате Markdown.

Что требуется для работы скилла с Confluence?

Нужен подключённый Atlassian MCP и адрес сайта (например, https://example.atlassian.net/) либо Cloud ID в виде UUID. Без них агент не сможет выполнить запросы к API.

Исходный текст

SKILL.md · CC-BY-4.0
---
name: confluence-assistant
description: Expert in Confluence operations using Atlassian MCP. Use when the user says "search Confluence", "create a Confluence page", "update a page", "find documentation in Confluence", "list spaces", or "add a comment to a page". Do NOT use for Jira issues, general web search, or local file creation.
license: CC-BY-4.0
metadata:
  author: Waldemar Neto - github.com/waldemarnt
  version: '1.0.0'
---

# Confluence Assistant

You are an expert in using Atlassian MCP tools to interact with Confluence.

## When to Use

Use this skill when the user asks to:

- Search for Confluence pages or documentation
- Create new Confluence pages
- Update existing Confluence pages
- Navigate or list Confluence spaces
- Add comments to pages
- Get details about specific pages

## Configuration

**Project Detection Strategy (Automatic):**

1. **Check conversation context first**: Look for Cloud ID or Confluence URL already mentioned
2. **If not found**: Ask the user to provide their Cloud ID or Confluence site URL
3. **Use detected values** for all Confluence operations in this conversation

### Configuration Detection Workflow

When you activate this skill:

1. Check if Cloud ID or Confluence URL is already available in the conversation context
2. If not found, ask: "Which Confluence site should I use? Please provide a Cloud ID (UUID) or site URL (e.g. `https://example.atlassian.net/`)"
3. Use the provided value for all operations in this conversation

**Cloud ID format:**

- Can be a site URL (e.g., `https://example.atlassian.net/`)
- Can be a UUID from `getAccessibleAtlassianResources`

## Workflow

### 1. Finding Content (Always Start Here)

**Use `search` (Rovo Search) first** - it's the most efficient way:

```
search("natural language query about the content")
```

- Works with natural language
- Returns relevant pages quickly
- Most efficient first step

### 2. Getting Page Details

Depending on what you have:

- **If you have ARI** (Atlassian Resource Identifier): `fetch(ari)`
- **If you have page ID**: `getConfluencePage(cloudId, pageId)`
- **To list spaces**: `getConfluenceSpaces(cloudId, keys=["SPACE_KEY"])`
- **For pages in a space**: `getPagesInConfluenceSpace(cloudId, spaceId)`

### 3. Creating Pages

```
createConfluencePage(
  cloudId,
  spaceId="123456",
  title="Page Title",
  body="# Markdown Content\n\n## Section\nContent here..."
)
```

Always use **Markdown** in the `body` field — never HTML.

### 4. Updating Pages

```
updateConfluencePage(
  cloudId,
  pageId="123456",
  title="Updated Title",
  body="# Updated Markdown Content\n\n..."
)
```

Always use **Markdown** in the `body` field — never HTML.

## Best Practices

### ✅ DO

- **Always use Markdown** for page `body` field
- **Use `search` first** before other lookup methods
- **Use natural language** in search queries
- **Validate space exists** before creating pages
- **Include clear structure** in page content (headings, lists, etc.)

### ⚠️ IMPORTANT

- **Don't confuse:**
  - Page ID (numeric) vs Space Key (string)
  - Space ID (numeric) vs Space Key (CAPS_STRING)
- **CloudId** can be URL or UUID - both work
- **Use detected configuration** - Check conversation context or ask user for Cloud ID / URL
- **ARI format**: `ari:cloud:confluence:site-id:page/page-id`

## Examples

### Example 1: Search and Update a Page

```
User: "Find the API documentation page and add a new section"

1. search("API documentation")
2. getConfluencePage(cloudId, pageId="found-id")
3. updateConfluencePage(
     cloudId,
     pageId="found-id",
     title="API Documentation",
     body="# API Documentation\n\n## Existing Content\n...\n\n## New Section\nNew content here..."
   )
```

### Example 2: Create a New Page in a Space

```
User: "Create a new architecture decision record"

1. getConfluenceSpaces(cloudId, keys=["TECH"])
2. createConfluencePage(
     cloudId,
     spaceId="space-id-from-step-1",
     title="ADR-001: Use Microservices Architecture",
     body="# ADR-001: Use Microservices Architecture\n\n## Status\nAccepted\n\n## Context\n...\n\n## Decision\n...\n\n## Consequences\n..."
   )
```

### Example 3: Find and Read Page Content

```
User: "What's in our onboarding documentation?"

1. search("onboarding documentation")
2. getConfluencePage(cloudId, pageId="id-from-results")
3. Summarize the content for the user
```

## Output Format

When creating or updating pages, use well-structured Markdown:

```markdown
# Main Title

## Introduction

Brief overview of the topic.

## Sections

Organize content logically with:

- Clear headings (##, ###)
- Bullet points for lists
- Code blocks for examples
- Tables when appropriate

## Key Points

- Point 1
- Point 2
- Point 3

## Next Steps

1. Step 1
2. Step 2
3. Step 3
```

## Important Notes

- **Markdown is mandatory** — never use HTML or other formats in `body`
- **Search first** — most efficient way to find content
- **Validate IDs** — ensure space/page IDs exist before operations
- **Natural language** — Rovo Search understands intent, not just keywords
- **ID types** — don't confuse page ID (numeric) vs space key (string) vs space ID (numeric)

© Waldemar Neto - github.com/waldemarnt · CC-BY-4.0 · tech-leads-club/agent-skills

Похожие скиллы

Все скиллы по теме «Тексты и документация» →
confluence-expert Alireza Rezvani Скилл confluence-expert для Claude Code и Codex создаёт и упорядочивает пространства и страницы Confluence, готовит шаблоны и проверяет состояние базы знаний. Настраивает структуру документации и её стандарты. CX Codex +1 781установок atlassian-templates borghei Скилл atlassian-templates для Claude Code, создающий, проверяющий и управляющий шаблонами Jira и Confluence на всю организацию. CX Codex +1 140установок pm-skills Alireza Rezvani Скилл pm-skills оркестрирует проектную работу через 8 PM-скиллов: Jira, Confluence, спринты, отчёты и коммуникации. Подходит для маршрутизации запросов и контроля delivery-цикла. CX Codex +1 1 975установок search-company-knowledge atlassian Скилл search-company-knowledge ищет информацию о процессах и системах одновременно в Confluence и Jira. Скилл пригодится, когда агенту нужно собрать факты из документации и тикетов со ссылками на источники. CX Codex +1 505установок atlassian sanjay3290 Скилл atlassian для Claude Code управляет задачами Jira и страницами Confluence из агента. Ищет тикеты через JQL, читает документацию и меняет статусы. CX Codex +1 329установок atlassian-confluence mcparmory atlassian-confluence — MCP-сервер для Claude Code, который подключает Confluence для поиска страниц, чтения вложений и редактирования базы знаний. CX Codex +1 ★ 32звёзд репо

Из того же набора130

Весь набор →
nx-workspace Скилл nx-workspace для работы с Nx-монорепозиторием из CLI: список проектов, полная конфигурация, поиск затронутых проектов и affected-команды в CI. CX Codex +1 ★ 7 191звёзд репо perf-web-optimization Скилл perf-web-optimization помогает оптимизировать загрузку веб-страниц: настраивает отложенную загрузку, сокращает размер бандла и выставляет кэш. Пригодится при медленной работе сайта или тяжёлом JS. CX Codex +1 ★ 7 191звёзд репо state-context-interface Правило state-context-interface для Claude Code: отделяет интерфейс компонентов от источника состояния через контекст с частями state, actions и meta. Один UI подключается к разным провайдерам состояния. CX Codex +1 ★ 7 191звёзд репо learning-opportunities Скилл learning-opportunities предлагает короткие учебные упражнения после архитектурной работы в Claude, чтобы код, который написал агент, не остался для вас чёрным ящиком. CX Codex +1 ★ 7 191звёзд репо security-threat-model Скилл security-threat-model строит модель угроз по коду репозитория: находит границы доверия, активы и реалистичные пути атаки, а результат сохраняет в Markdown-файл. CX Codex +1 ★ 7 191звёзд репо modular-decomposition Скилл modular-decomposition проводит монолит через пять шагов анализа перед разбивкой на модули: размер и инвентаризация компонентов, дублирование логики, иерархия, связность, группировка по доменам. CX Codex +1 ★ 7 191звёзд репо tlc-plan Скилл tlc-plan превращает PRD, тикеты и обсуждения в строгий план разработки. Уточняет серые зоны до написания кода и фиксирует критерии приёмки. CX Codex +1 ★ 7 191звёзд репо legacy-migration-planner Скилл legacy-migration-planner планирует миграцию легаси-систем, модернизацию кодовой базы и разбиение монолита. Он пригодится до начала работ, когда нужен план перехода. CX Codex +1 ★ 7 191звёзд репо

Ещё в каталоге

Спонсоры проекта

Компании, которые помогают держать аналитику открытой