confluence-publisher

Publish Markdown, storage XHTML, or plain text to Confluence pages.

15|5|Updated May 4, 2026
One-click install
npx skills add https://github.com/eugenelim/agent-ready-repo --skill confluence-publisher
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: confluence-publisher
Source: https://github.com/eugenelim/agent-ready-repo/tree/main/packs/atlassian/.apm/skills/confluence-publisher
Command: npx skills add https://github.com/eugenelim/agent-ready-repo --skill confluence-publisher

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires httpx, markdown-it-py, pyyaml, credbroker, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill removes the friction of publishing and republishing content to Confluence by handling page lookup, authentication, formatting, attachments, and update conflicts for you.

Core Features & Use Cases

  • Create or update pages: Publish Markdown, storage XHTML, or plain text to an existing page or a new page in Confluence Cloud or Server/Data Center.
  • Flexible target resolution: Target a page by ID, URL, YAML frontmatter, or space plus title, including lookup-or-create workflows.
  • Reliable publishing workflows: Verify credentials, upload attachments, apply labels, and recover from optimistic-locking conflicts with a retry.
  • Use case: A team can draft a design doc locally, attach diagrams, and republish it to the correct Confluence page without manually editing the wiki.

Quick Start

Ask the agent to publish your prepared document to the right Confluence page by specifying the page ID, URL, frontmatter, or space and title.

Frequently Asked Questions about confluence-publisher

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

FAQPage Schema
How do I publish markdown to Confluence and keep the page in sync?

Publishing markdown to Confluence involves converting content to storage XHTML, resolving the target page by ID or URL, and handling frontmatter round-trips to keep the page in sync across updates.

Can I resolve a Confluence page by URL or space and title for lookup-or-create publishing?

Yes, lookup-or-create publishing supports resolving target Confluence pages by ID, URL, YAML frontmatter, or space plus title to find existing pages or create new ones automatically.

Does this workflow support uploading attachments and applying labels to Confluence pages?

Yes, the publishing workflow supports uploading attachments, applying labels, and verifying credentials to ensure documents and diagrams are published correctly to Confluence Cloud or Server/Data Center.

What happens when a Confluence page update fails due to optimistic-locking conflicts?

When a Confluence page update fails due to optimistic-locking conflicts, the Skill applies retry logic to automatically recover and complete the publishing workflow without manual intervention.

Do I need credentialed authentication to publish content to Confluence Cloud and Server?

Yes, credentialed authentication is required to publish content to Confluence Cloud and Server/Data Center, ensuring secure page updates and attachment uploads through verified access.

What is the best way to republish design docs locally without manually editing the wiki?

The best way to republish design docs without manually editing the wiki is to draft locally with attachments and use markdown-to-storage conversion to sync the content to the correct Confluence page.