write-confluence

Convert Markdown to Confluence storage format and publish or update pages.

Updated Apr 6, 2026
One-click install
npx skills add https://github.com/son-nguyen-301/hydra-claude --skill write-confluence
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: write-confluence
Source: https://github.com/son-nguyen-301/hydra-claude/tree/main/skills/write-confluence
Command: npx skills add https://github.com/son-nguyen-301/hydra-claude --skill write-confluence

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Publishing and maintaining Confluence pages manually is error-prone and time-consuming. This Skill automates the creation and updates, ensuring pages reflect the latest source material and reducing repetitive edits.

Core Features & Use Cases

  • Create or update Confluence pages by page ID, URL, or title plus space key, with automatic Markdown-to-Confluence XHTML conversion.
  • Handle versioning and conflicts by reading current versions, applying updates, and retrying once on conflicts.
  • Integrate into existing workflows to generate content from source materials and publish to Confluence without leaving your terminal.

Quick Start

Publish or update a Confluence page by supplying a Markdown document and a target page identifier or space key.

Frequently Asked Questions about write-confluence

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

FAQPage Schema
How do I publish Markdown content to a Confluence page automatically?

To publish Markdown to Confluence, this Skill converts the Markdown source into Confluence storage format XHTML and creates or updates the target page via Confluence APIs. You supply a Markdown document and a target page identifier or space key.

How does version conflict handling work when updating Confluence pages via API?

Version conflict handling for Confluence pages works by reading the current page version, applying the update, and retrying once if a conflict occurs. This ensures your Markdown edits do not overwrite concurrent changes made by other users.

Can I update an existing Confluence page using a URL or title instead of a page ID?

Yes, you can update an existing Confluence page by supplying the page ID, URL, or the page title combined with the space key. The Skill resolves these identifiers to apply versioned edits to the correct page.

Does this Skill convert Markdown directly to Confluence storage format?

Yes, this Skill converts Markdown directly to Confluence storage format XHTML. This conversion is required because Confluence APIs expect storage format to properly render page content, structure, and formatting.

What is the best way to automate Confluence page management from a terminal workflow?

Automating Confluence page management from a terminal is best done by integrating this Skill into your existing workflows. It generates content from Markdown source materials and publishes updates to Confluence APIs without requiring manual browser interaction.