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@example.com', 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:name="style">disc <ac:parameter ac:name="maxLevel">3
Overview
Brief description of the system...
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
Endpoints
GET /agents
List all agents.
<ac:structured-macro ac:name="expand"> <ac:parameter ac:name="title">Example Response ac:rich-text-body <ac:structured-macro ac:name="code"> <ac:parameter ac:name="language">json ac:plain-text-body ```
Meeting Notes
```html
Meeting Notes: Meeting Title
<ac:structured-macro ac:name="info"> ac:rich-text-body
Date: ac:placeholderDate
Attendees: ac:placeholderNames
Agenda
- Topic 1
- Topic 2
Discussion
Notes from discussion...
Action Items
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:plain-text-body
<ac:structured-macro ac:name="info"> ac:rich-text-body
Info text
<ac:structured-macro ac:name="warning"> ac:rich-text-body
Warning text
<ac:structured-macro ac:name="expand"> <ac:parameter ac:name="title">Click to expand ac:rich-text-body
Hidden content
<ac:structured-macro ac:name="status"> <ac:parameter ac:name="colour">Green <ac:parameter ac:name="title">COMPLETED
<ac:structured-macro ac:name="jira"> <ac:parameter ac:name="key">GA-123 ```
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
- 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