About confluence
A Confluence skill for documentation and space operations, using the Confluence API and Python examples. It covers page management, search, templates, macros, and documentation practices for the Golden Armada AI Agent Fleet Platform.
Key features
- 01Create, retrieve, update, and delete pages
- 02Create and inspect spaces
- 03Search with CQL or page queries
- 04Use documentation templates and macros
- 05Follow page organization practices
Use cases
- 01Create or update Confluence documentation
- 02Find pages by text or space
- 03Organize architecture and meeting notes
Install
Copy the command and run it in a terminal.
npx skills add https:/After installing, type/confluencein Claude Code to confirm it loaded.
Details
From the project READMEConfluence 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
bashEndpoints
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 1Next 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