Mastering Confluence - AI Agent Skill

A comprehensive AI agent skill for managing Confluence documentation, including Wiki Markup mastery, Markdown conversion, Mermaid diagram integration, and seamless interaction with the Atlassian MCP server.

Key Features

• Upload/Download: Seamlessly sync Markdown files with Confluence pages
• Format Conversion: Convert between Markdown and Wiki Markup formats
• Diagram Support: Render Mermaid/PlantUML diagrams and embed in pages
• Image Handling: Automatic image upload and attachment management
• CQL Search: Advanced Confluence Query Language support
• Git Integration: Sync documentation from Git repos using mark CLI
• No Size Limits: Upload large documents without API restrictions

---

Installing with Skilz (Universal Installer)

The recommended way to install this skill is using the skilz universal installer, which supports 14+ AI coding agents.

Step 1: Install Skilz

pip install skilz

Step 2: Install the Skill

From SkillzWave Marketplace (Recommended):

# Claude Code (user-level, available in all projects)
skilz install SpillwaveSolutions_mastering-confluence-agent-skill/mastering-confluence

# Claude Code (project-level only)
skilz install SpillwaveSolutions_mastering-confluence-agent-skill/mastering-confluence --project

From GitHub:

# Using HTTPS
skilz install -g https://github.com/SpillwaveSolutions/mastering-confluence-agent-skill

# Using SSH
skilz install --git git@github.com:SpillwaveSolutions/mastering-confluence-agent-skill.git

Other AI Agents

# OpenCode
skilz install SpillwaveSolutions_mastering-confluence-agent-skill/mastering-confluence --agent opencode

# OpenAI Codex
skilz install SpillwaveSolutions_mastering-confluence-agent-skill/mastering-confluence --agent codex

# Gemini CLI
skilz install SpillwaveSolutions_mastering-confluence-agent-skill/mastering-confluence --agent gemini

# Cursor
skilz install SpillwaveSolutions_mastering-confluence-agent-skill/mastering-confluence --agent cursor

# Add --project flag for project-level installation

Supported Platforms

This skill follows the Agent Skill Standard and supports 14+ coding agents including: Claude Code, OpenAI Codex, OpenCode, Cursor, Gemini CLI, GitHub Copilot CLI, Windsurf, Qwen Code, Aidr, and more.

Resources:

• SkillzWave Marketplace Listing
• All Supported Platforms
• Skilz CLI Documentation

---

What is a Skill?

A skill is an instruction manual that teaches Claude Code how to use MCP (Model Context Protocol) tools effectively. Think of it this way:

• MCP Server (Atlassian MCP) = The tool that provides access to Confluence APIs
• Skill (this repository) = The instruction manual that guides Claude on best practices, conversion patterns, and workflows for using that tool

Claude Code can discover and use MCP tools automatically, but skills provide the critical context, workflows, and domain expertise that make interactions efficient, reliable, and consistent with documentation best practices.

How This Skill Works

This skill works hand-in-glove with the Atlassian MCP server (mcp__atlassian). The MCP provides raw access to Confluence's API capabilities, while this skill provides:

• Format conversion expertise for Markdown ↔ Wiki Markup transformations
• Diagram rendering workflows for Mermaid to PNG/SVG conversion
• CQL query construction guidance and examples
• mark CLI integration for Git-to-Confluence synchronization
• Best practices for page creation, updates, and content organization
• Troubleshooting guides for common errors and edge cases

When you ask Claude Code to work with Confluence, this skill ensures operations follow proven patterns, handle format conversions correctly, and maintain documentation quality.

Installation Levels

This skill can be installed at multiple levels depending on your organizational structure and needs:

1. Global Installation (User Level)

Install in your home directory for use across all projects:

~/.claude/skills/confluence/

Use case: You work with a single Confluence instance across all projects.

2. Project-Level Installation

Install within a specific project direct

...