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
confluence = Confluence(url='[https://your-domain.atlassian.net](https://your-domain.atlassian.net)', username='[email@example.com](https://github.com/lobbi-docs/claude/blob/HEAD/.claude/skills/confluence/mailto: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
<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](https://github.com/lobbi-docs/claude/blob/HEAD/.claude/skills/confluence/ac:rich-text-body) Date: [ac:placeholder](https://github.com/lobbi-docs/claude/blob/HEAD/.claude/skills/confluence/ac:placeholder)Date</ac:placeholder> Attendees: [ac:placeholder](https://github.com/lobbi-docs/claude/blob/HEAD/.claude/skills/confluence/ac:placeholder)Names</ac:placeholder> </ac:rich-text-body> </ac:structured-macro>
## Macros Reference
### Common Macros
<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
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