publish-to-confluence

Convert markdown documents to Confluence XHTML and publish after user approval.

Updated Apr 4, 2026
One-click install
npx skills add https://github.com/Boboegg/COG-second-brain --skill publish-to-confluence
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: publish-to-confluence
Source: https://github.com/Boboegg/COG-second-brain/tree/main/.claude/skills/publish-to-confluence
Command: npx skills add https://github.com/Boboegg/COG-second-brain --skill publish-to-confluence

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, json, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill streamlines the process of publishing markdown files to Confluence, ensuring format conversion and user approval before publication.

Core Features & Use Cases

  • Markdown to Confluence Conversion: Converts markdown files to Confluence's storage format (XHTML) for seamless integration.
  • User Approval: Ensures explicit user approval before publishing to avoid accidental overwrites.
  • Publishing Options: Allows users to choose between creating a new page or updating an existing one.
  • Use Case: Ideal for product managers, engineering leads, and founders who need to share documentation with their team on Confluence.

Quick Start

Use the /publish-to-confluence command to publish your markdown document to Confluence.

Frequently Asked Questions about publish-to-confluence

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I publish markdown files to Confluence?

To publish markdown files to Confluence, use the /publish-to-confluence command. It converts your markdown to Confluence XHTML format and requires your explicit approval before creating or updating the page in your specified space.

Does this markdown to Confluence conversion require approval before publishing?

Yes, the markdown to Confluence conversion requires explicit user approval before publishing. This safeguard ensures you review the XHTML format and choose between creating a new page or updating an existing one to prevent accidental overwrites.

What is the process to convert markdown to Confluence XHTML format?

The process to convert markdown to Confluence XHTML format involves transforming the document structure into Confluence's storage format. The Skill handles the markdown conversion, user authentication, and API interactions automatically.

Can I update an existing Confluence page with a markdown file?

Yes, you can update an existing Confluence page with a markdown file. The publishing options allow you to choose between creating a new page or updating an existing one within a specified Confluence space and parent page.

How does the Skill handle API failures and network issues during Confluence publishing?

The Skill handles API failures and network issues during Confluence publishing through built-in error handling. It manages user authentication and processes errors to ensure robust publishing of your markdown documents.

Is Confluence markdown publishing suitable for product managers and engineering leads?

Confluence markdown publishing is suitable for product managers, engineering leads, and founders who need to share documentation with their team. It streamlines format conversion and ensures user approval before publication.