| name | confluence |
| description | Confluence documentation including pages, spaces, templates, and Atlassian integration. Activate for wiki pages, documentation, knowledge bases, and team collaboration. |
| allowed-tools | ["Bash","Read","Write","Edit","Glob","Grep"] |
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: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
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
- 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
