Confluence Expert

What This Skill Does

This skill provides master-level expertise in Confluence space management, documentation architecture, content creation, macros, templates, and collaborative knowledge management. It helps users effectively organize and manage their Confluence spaces. It's designed for Confluence administrators, documentation teams, and project managers.

When to Use

• Create a new Confluence space for a team.
• Design a page architecture for a knowledge base.
• Update an existing Confluence page with new content.
• Search for pages using CQL queries.
• Apply labels to Confluence pages.
• Configure space permissions for different user groups.

Key Features

• Manages Confluence spaces, pages, and permissions.
• Integrates with the Confluence MCP Server.
• Supports CQL queries for advanced searching.
• Provides best practices for page architecture.
• Offers expertise in macros and templates.
• Automates space creation and content updates.

Atlassian MCP Integration

Primary Tool: Confluence MCP Server

Key Operations:

// Create a new space create_space({ key: "TEAM", name: "Engineering Team", description: "Engineering team knowledge base" })

// Create a page under a parent create_page({ spaceKey: "TEAM", title: "Sprint 42 Notes", parentId: "123456", body: "<p>Meeting notes in storage-format HTML</p>" })

// Update an existing page (version must be incremented) update_page({ pageId: "789012", version: 4, body: "<p>Updated content</p>" })

// Delete a page delete_page({ pageId: "789012" })

// Search with CQL search({ cql: 'space = "TEAM" AND label = "meeting-notes" ORDER BY lastModified DESC' })

// Retrieve child pages for hierarchy inspection get_children({ pageId: "123456" })

// Apply a label to a page add_label({ pageId: "789012", label: "archived" })

Integration Points: Create documentation for Senior PM projects Support Scrum Master with ceremony templates Link to Jira issues for Jira Expert Provide templates for Template Creator

See also: MACROS.md for macro syntax reference, TEMPLATES.md for full template library, PERMISSIONS.md for permission scheme details.

Workflows

Space Creation

Determine space type (Team, Project, Knowledge Base, Personal) Create space with clear name and description Set space homepage with overview Configure space permissions:

• View, Edit, Create, Delete
• Admin privileges Create initial page tree structure Add space shortcuts for navigation Verify: Navigate to the space URL and confirm the homepage loads; check that a non-admin test user sees the correct permission level HANDOFF TO: Teams for content population

Page Architecture

Best Practices: Use page hierarchy (parent-child relationships) Maximum 3 levels deep for navigation Consistent naming conventions Date-stamp meeting notes

Recommended Structure: Space Home ├── Overview & Getting Started ├── Team Information │ ├── Team Members & Roles │ ├── Communication Channels │ └── Working Agreements ├── Projects │ ├── Project A │ │ ├── Overview │ │ ├── Requirements │ │ └── Meeting Notes │ └── Project B ├── Processes & Workflows ├── Meeting Notes (Archive) └── Resources & References

Template Creation

Identify repeatable content pattern Create page with structure and placeholders Add instructions in placeholders Format with appropriate macros Save as template Share with space or make global Verify: Create a test page from the template and confirm all placeholders render correctly before sharing with the team USE: References for advanced template patterns

Documentation Strategy

Assess current documentation state Define documentation goals and audience Organize content taxonomy and structure Create templates and guidelines Migrate existing documentation Train teams on best practices Monitor usage and adoption REPORT TO: Senior PM on documentation health

Knowledge Base Management

Article Types: How-to guides Troubleshooting docs FAQs Reference documentation Process documentation

Quality Standards: Clear title and description Structured with headings Updated date visible Owner identified Reviewed quarterly

Essential Macros

Full macro reference with all parameters: see MACROS.md.

Content Macros

Info, Note, Warning, Tip: {info} Important information here {info}

Expand: {expand:title=Click to expand} Hidden content here {expand}

Table of Contents: {toc:maxLevel=3}

Excerpt & Excerpt Include: {excerpt} Reusable content {excerpt}

{excerpt-include:Page Name}

Dynamic Content

Jira Issues: {jira:JQL=project = PROJ AND status = "In Progress"}

Jira Chart: {jirachart:type=pie|jql=project = PROJ|statType=statuses}

Recently Updated: {recently-updated:spaces=@all|max=10}

Content by Label: {contentbylabel:label=meeting-notes|maxResults=20}

Collaboration Macros

Status: {status:colour=Green|title=Approved}

Task List: {tasks} [ ] Task 1 [x] Task 2 completed {tasks}

User Mention: @username

Date: {date:format=dd MMM yyyy}

Page Layouts & Formatting

Two-Column Layout: {section} {column:width=50%} Left content {column} {column:width=50%} Right content {column} {section}

Panel: {panel:title=Panel Title|borderColor=#ccc} Panel content {panel}

Code Block: {code:javascript} const example = "code here"; {code}

Templates Library

Full template library with complete markup: see TEMPLATES.md. Key templates summarised below.

Space Permissions

Full permission scheme details: see PERMISSIONS.md.

Permission Schemes

Public Space: All users: View Team members: Edit, Create Space admins: Admin

Team Space: Team members: View, Edit, Create Team leads: Admin Others: No access

Project Space: Stakeholders: View Project team: Edit, Create PM: Admin

Content Governance

Review Cycles: Critical docs: Monthly Standard docs: Quarterly Archive docs: Annually

Archiving Strategy: Move outdated content to Archive space Label with "archived" and date Maintain for 2 years, then delete Keep audit trail

Content Quality Checklist: [ ] Clear, descriptive title [ ] Owner/author identified [ ] Last updated date visible [ ] Appropriate labels applied [ ] Links functional [ ] Formatting consistent [ ] No sensitive data exposed

Decision Framework

When to Escalate to Atlassian Admin: Need org-wide template Require cross-space permissions Blueprint configuration Global automation rules Space export/import

When to Collaborate with Jira Expert: Embed Jira queries and charts Link pages to Jira issues Create Jira-based reports Sync documentation with tickets

When to Support Scrum Master: Sprint documentation templates Retrospective pages Team working agreements Process documentation

When to Support Senior PM: Executive report pages Portfolio documentation Stakeholder communication Strategic planning docs

Handoff Protocols

FROM Senior PM: Documentation requirements Space structure needs Template requirements Knowledge management strategy

TO Senior PM: Documentation coverage reports Content usage analytics Knowledge gaps identified Template adoption metrics

FROM Scrum Master: Sprint ceremony templates Team documentation needs Meeting notes structure Retrospective format

TO Scrum