Confluence Skill for Claude Code

A comprehensive Claude Code skill that provides expert guidance for managing Confluence documentation, including Wiki Markup mastery, Markdown conversion, Mermaid diagram integration, and seamless interaction with the Atlassian MCP server.

---

Table of Contents

• What is a Skill?
• How This Skill Works
• Installing with Skilz (Universal Installer)
• Installation Levels
• Multi-Instance Confluence Support
• Prerequisites
• Quick Start
• Uploading Markdown to Confluence
• Features
• File Structure
• Key Documentation
• Common Workflows
• Best Practices
• Troubleshooting
• Integration with Other Skills
• Advanced Usage
• CI/CD Integration
• Updates and Maintenance
• Support
• Contributing
• License
• Related Resources

---

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-evinova). The MCP provides raw access to Confluence's API capabilities, while this skill provides:

• Format conversion expertise for Markdown to 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.

---

Installing with Skilz (Universal Installer)

The recommended way to install this skill across different AI coding agents is using the skilz universal installer.

Install Skilz

pip install skilz

This skill supports Agent Skill Standard which means it supports 14 plus coding agents including Claude Code, OpenAI Codex, Cursor and Gemini.

Git URL Options

You can use either -g or --git with HTTPS or SSH URLs:

# HTTPS URL
skilz install -g https://github.com/SpillwaveSolutions/confluence-skill

# SSH URL
skilz install --git git@github.com:SpillwaveSolutions/confluence-skill.git

Claude Code

Install to user home (available in all projects):

skilz install -g https://github.com/SpillwaveSolutions/confluence-skill

Install to current project only:

skilz install -g https://github.com/SpillwaveSolutions/confluence-skill --project

OpenCode

Install for OpenCode:

skilz install -g https://github.com/SpillwaveSolutions/confluence-skill --agent opencode

Project-level install:

skilz install -g https://github.com/SpillwaveSolutions/confluence-skill --project --agent opencode

Gemini

Project-level install for Gemini:

skilz install -g https://github.com/SpillwaveSolutions/confluence-skill --agent gemini

OpenAI Codex

Install for OpenAI Codex:

skilz install -g https://github.com/SpillwaveSolutions/confluence-skill --agent codex

Project-level install:

skilz install -g https://github.com/SpillwaveSolutions/confluence-skill --project --agent codex

Install from Skillzwave Marketplace

# Claude to user home dir ~/.claude/skills
skilz install SpillwaveSolutions_confluence-skill/confluence

# Claude skill in project folder ./claude/skills
skilz install SpillwaveSolutions_confluence-skill/confluence --project

# OpenCode install to user home dir ~

...