Confluence Skill

Provides comprehensive Confluence documentation capabilities for the Golden Armada AI Agent Fleet Platform.

When to Use This Skill

Activate this skill when working with:

• Documentation pages

• Space management

• Templates and blueprints

• Knowledge base creation

• Confluence API integration

Confluence API Quick Reference

Authentication

from atlassian import Confluence

confluence = Confluence(
url='https://your-domain.atlassian.net',
username='email@example.com',
password='API_TOKEN',
cloud=True
)

Page Operations

Create page

page = confluence.create_page(
space='GA',
title='Agent Architecture',
body='OverviewArchitecture documentation...',
parent_id=12345  # Optional parent page
)

Get page

page = confluence.get_page_by_title(
space='GA',
title='Agent Architecture',
expand='body.storage,version'
)

Get page by ID

page = confluence.get_page_by_id(
page_id=12345,
expand='body.storage,version'
)

Update page

confluence.update_page(
page_id=12345,
title='Agent Architecture v2',
body='Updated OverviewNew content...'
)

Delete page

confluence.remove_page(page_id=12345)

Get page content

content = confluence.get_page_by_id(page_id, expand='body.storage')
html_content = content['body']['storage']['value']

Space Operations

Create space

space = confluence.create_space(
space_key='GA',
space_name='Golden Armada',
description='AI Agent Fleet Platform documentation'
)

Get space

space = confluence.get_space('GA', expand='homepage')

Get all pages in space

pages = confluence.get_all_pages_from_space(
space='GA',
start=0,
limit=100,
expand='body.storage'
)

Search

CQL search

results = confluence.cql(
'space = GA AND type = page AND text ~ "agent"',
limit=25
)

Search pages

results = confluence.search(
query='agent architecture',
space='GA',
type='page'
)

Page Templates

Architecture Document

<ac:structured-macro ac:name="toc">
<ac:parameter ac:name="printable">true</ac:parameter>
<ac:parameter ac:name="style">disc</ac:parameter>
<ac:parameter ac:name="maxLevel">3</ac:parameter>
</ac:structured-macro>

API Documentation

```html

<ac:structured-macro ac:name="expand">
<ac:parameter ac:name="title">Example Response</ac:parameter>
ac:rich-text-body
<ac:structured-macro ac:name="code">
<ac:parameter ac:name="language">json</ac:parameter>
ac:plain-text-body</ac:plain-text-body>
</ac:structured-macro>
</ac:rich-text-body>
</ac:structured-macro>

Meeting Notes

<ac:structured-macro ac:name="info">
ac:rich-text-body
Date: ac:placeholderDate</ac:placeholder>
Attendees: ac:placeholderNames</ac:placeholder>
</ac:rich-text-body>
</ac:structured-macro>

Macros Reference

Common Macros

```html

<ac:structured-macro ac:name="toc"/>

<ac:structured-macro ac:name="code">
<ac:parameter ac:name="language">python</ac:parameter>
ac:plain-text-body</ac:plain-text-body>
</ac:structured-macro>

<ac:structured-macro ac:name="info">
ac:rich-text-bodyInfo text</ac:rich-text-body>
</ac:structured-macro>

<ac:structured-macro ac:name="warning">
ac:rich-text-bodyWarning text</ac:rich-text-body>
</ac:structured-macro>

<ac:structured-macro ac:name="expand">
<ac:parameter ac:name="title">Click to expand</ac:parameter>
ac:rich-text-bodyHidden content</ac:rich-text-body>
</ac:structured-macro>

<ac:structured-macro ac:name="status">
<ac:parameter ac:name="colour">Green</ac:parameter>
<ac:parameter ac:name="title">COMPLETED</ac:parameter>
</ac:structured-macro>

<ac:structured-macro ac:name="jira">
<ac:parameter ac:name="key">GA-123</ac:parameter>
</ac:structured-macro>

Golden Armada Commands

Publish to Confluence

/confluence-publish --space GA --title "Agent API Docs" --file docs/api.md

Update page

/confluence-update --page-id 12345 --file docs/updated.md

Sync documentation

/atlassian-sync --confluence --space GA

Best Practices

• Use templates for consistent documentation

• Organize with page hierarchy (parent/child pages)

• Include diagrams for complex concepts

• Link to Jira issues for traceability

• Version important pages with labels

• Use macros for dynamic content