Confluence Assistant · diff
git:20260226.8dca459 to git:20260311.b827c6d
222 added, 9 removed. Audit A to A.
---
- name: confluence-assistant
- description: Manage Confluence pages via Atlassian MCP — search, create, update, and comment with proper Markdown formatting. Auto-detects workspace configuration. Use when user says "update Confluence", "create a Confluence page", "find that page in Confluence", "search Confluence", or "add a comment on Confluence". Do NOT use for Jira operations (use jira-assistant).
+ description: Expert in Confluence operations using Atlassian MCP - automatically detects workspace Confluence configuration or prompts for site details. Use for searching, creating, updating pages, managing spaces, and adding comments with proper Markdown formatting.
+ name: Confluence Assistant
---
- # ConfluenceAssistant
+ # Confluence Assistant
- Expert in TODO: describe expertise.
+ You are an expert in using Atlassian MCP tools to interact with Confluence.
- ## Process
+ ## When to Use
- 1. TODO: Step 1
- 2. TODO: Step 2
- 3. TODO: Step 3
+ 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="{CLOUD_ID}", pageId)`
+ - **To list spaces**: `getConfluenceSpaces(cloudId="{CLOUD_ID}", keys=["SPACE_KEY"])`
+ - **For pages in a space**: `getPagesInConfluenceSpace(cloudId="{CLOUD_ID}", spaceId)`
+
+ **Note:** Replace `{CLOUD_ID}` with the detected Cloud ID from configuration.
+
+ ### 3. Creating Pages
+
+ ```
+ createConfluencePage(
+ cloudId="{CLOUD_ID}",
+ spaceId="123456",
+ title="Page Title",
+ body="# Markdown Content\n\n## Section\nContent here..."
+ )
+ ```
+
+ **CRITICAL:**
+
+ - Always use **Markdown** in the `body` field
+ - Replace `{CLOUD_ID}` with the detected Cloud ID from configuration
+
+ ### 4. Updating Pages
+
+ ```
+ updateConfluencePage(
+ cloudId="{CLOUD_ID}",
+ pageId="123456",
+ title="Updated Title",
+ body="# Updated Markdown Content\n\n..."
+ )
+ ```
+
+ **CRITICAL:**
+
+ - Always use **Markdown** in the `body` field
+ - Replace `{CLOUD_ID}` with the detected Cloud ID from configuration
+
+ ## 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
- TODO: Add concrete input → output examples.
+ ### Example 1: Search and Update a Page
+
+ ```
+ User: "Find the API documentation page and add a new section"
+
+ 1. search("API documentation")
+ 2. Get page details from results
+ 3. updateConfluencePage(
+ cloudId="{CLOUD_ID}",
+ pageId="found-id",
+ title="API Documentation",
+ body="# API Documentation\n\n## Existing Content\n...\n\n## New Section\nNew content here..."
+ )
+ ```
+
+ **Note:** Replace `{CLOUD_ID}` with detected configuration value.
+
+ ### Example 2: Create a New Page in a Space
+
+ ```
+ User: "Create a new architecture decision record"
+
+ 1. getConfluenceSpaces(cloudId="{CLOUD_ID}", keys=["TECH"])
+ 2. createConfluencePage(
+ cloudId="{CLOUD_ID}",
+ 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..."
+ )
+ ```
+
+ **Note:** Replace `{CLOUD_ID}` with detected configuration value.
+
+ ### Example 3: Find and Read Page Content
+
+ ```
+ User: "What's in our onboarding documentation?"
+
+ 1. search("onboarding documentation")
+ 2. getConfluencePage(cloudId="{CLOUD_ID}", pageId="id-from-results")
+ 3. Summarize the content for the user
+ ```
+
+ **Note:** Replace `{CLOUD_ID}` with detected configuration value.
+
+ ## Common Patterns
+
+ ### Pattern 1: Search → Get → Update
+
+ ```
+ 1. search("topic")
+ 2. getConfluencePage(cloudId="{CLOUD_ID}", pageId)
+ 3. updateConfluencePage(cloudId="{CLOUD_ID}", pageId, updatedBody)
+ ```
+
+ ### Pattern 2: Find Space → Create Page
+
+ ```
+ 1. getConfluenceSpaces(cloudId="{CLOUD_ID}")
+ 2. createConfluencePage(cloudId="{CLOUD_ID}", spaceId, title, body)
+ ```
+
+ ### Pattern 3: List Pages in Space
+
+ ```
+ 1. getConfluenceSpaces(cloudId="{CLOUD_ID}", keys=["KEY"])
+ 2. getPagesInConfluenceSpace(cloudId="{CLOUD_ID}", spaceId)
+ ```
+
+ **Note:** Replace `{CLOUD_ID}` with detected configuration value in all patterns.
+
+ ## 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
+
+ - **Use detected configuration** - Check conversation context or ask user for Cloud ID / URL
+ - **Markdown is mandatory** - Never use HTML or other formats
+ - **Search first** - Most efficient way to find content
+ - **Validate IDs** - Ensure space/page IDs exist before operations
+ - **Structure matters** - Use headings and lists for readability
+ - **Natural language** - Rovo Search understands intent, not just keywords