confluence

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

```python from atlassian import Confluence

confluence = Confluence( url='https://your-domain.atlassian.net', username='[email protected]', password='API_TOKEN', cloud=True ) ```

Page Operations

```python

Create page

page = confluence.create_page( space='GA', title='Agent Architecture', body='

Overview

Architecture 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 Overview

New 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

```python

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

```python

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

```html

System Architecture

<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>

Overview

Brief description of the system...

Components

Key Components

• Component 1 - Description
• Component 2 - Description

Architecture Diagram

Data Flow

Description of data flow...

Security Considerations

Security notes...

\`\`\`

API Documentation

```html

API Reference

Authentication

bash

Endpoints

GET /agents

List all agents.

<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

```html

Meeting Notes: Meeting Title

<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>

Agenda

• Topic 1
• Topic 2

Discussion

Notes from discussion...

Action Items

incomplete Action item 1

Next Steps

Follow-up items...

\`\`\`

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-body

Info text

</ac:rich-text-body> </ac:structured-macro>

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

Warning 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-body

Hidden 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

```bash

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

1. Use templates for consistent documentation
2. Organize with page hierarchy (parent/child pages)
3. Include diagrams for complex concepts
4. Link to Jira issues for traceability
5. Version important pages with labels
6. Use macros for dynamic content