Does it support incremental updates?

Yes. It tracks synchronization timestamps in your sdd-config.yaml file and only updates pages where the local Markdown file has a more recent modification time than the last sync.

How are Mermaid diagrams handled?

The skill extracts Mermaid code blocks from your Markdown, uses the Mermaid CLI to render them as PNGs, and then automatically uploads and embeds them as attachments in the corresponding Confluence page.

What are the prerequisites for using sdd-publish?

You need a configured sdd-config.yaml file with Confluence space details and access to an MCP server that provides Confluence API capabilities.

Does this skill just upload plain HTML to Confluence?

No, it performs a deep conversion into Confluence Storage Format. This ensures that elements like code blocks, status badges, and panels use native Confluence macros rather than simple HTML tags.

Can I publish specific documents instead of the whole project?

Yes, you can use specific flags like --stage (e.g., spec, plan) or --domain, or run the command without arguments to enter an interactive selection mode where you can pick individual files.

SDD Confluence Publisher

Name: SDD Confluence Publisher
Author: joypop-lguplus

byjoypop-lguplus

•

学习与文档

Publishes Software Design Documents to Confluence with automated Markdown-to-Storage-Format conversion and Mermaid diagram rendering.

The sdd-publish skill streamlines the documentation lifecycle for development teams using Claude Code by synchronizing local Markdown specifications with Atlassian Confluence. It goes beyond simple text uploading by transforming standard Markdown into native Confluence Storage Format, ensuring that code blocks, info panels, and tables appear as native macros. Additionally, it automates the rendering of Mermaid diagrams into high-quality PNG attachments, maintaining a professional and synchronized documentation site without manual effort. It is an essential tool for teams who want to keep their technical specifications in version control while providing accessible, formatted documentation for stakeholders.

主要功能

01Interactive document selection and stage-specific publishing (spec, intake, architecture, etc.)

021 GitHub stars

03Incremental synchronization with intelligent change detection and timestamping

04Converts Markdown to native Confluence Storage Format macros (code, info, warning, tip)

05Automated Mermaid-to-PNG rendering and attachment management

06Automatic management of parent-child page hierarchies for complex projects

使用场景

01Publishing specific lifecycle stages like 'requirements' or 'reviews' to maintain stakeholder alignment

02Synchronizing architecture and API specifications from a Git repository to a team Confluence space

03Automatically updating technical diagrams in Confluence whenever Mermaid source code is modified

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add joypop-lguplus/claude-sdd sdd-publish

For use in Claude.ai and ChatGPT

Download Skill