confluence
Confluence documentation including pages, spaces, templates, and Atlassian integration. Activate for wiki pages, documentation, knowledge bases, and team collaboration.
When & Why to Use This Skill
The Confluence skill enables Claude to seamlessly manage Atlassian Confluence environments, providing automated capabilities for creating, updating, and organizing documentation. It streamlines knowledge management by supporting full page and space CRUD operations, advanced CQL searching, and the implementation of structured templates and macros for professional-grade wikis.
Use Cases
- Automated Technical Documentation: Generate and maintain up-to-date system architectures, API references, and developer guides directly from project data using standardized templates.
- Centralized Knowledge Management: Build and organize comprehensive team spaces and knowledge bases with parent-child hierarchies to ensure information is easily discoverable.
- Meeting and Project Tracking: Automatically create structured meeting notes, record discussion points, and track action items using integrated Confluence macros and task lists.
- Documentation Synchronization: Sync local markdown files and technical specifications to Confluence pages via command-line tools to keep internal documentation consistent with development cycles.
| name | confluence |
|---|---|
| description | Confluence documentation including pages, spaces, templates, and Atlassian integration. Activate for wiki pages, documentation, knowledge bases, and team collaboration. |
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
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: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
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: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