{"slug":"publish-to-confluence-3","title":"publish-to-confluence","summary":"Publish any markdown file from the vault to Confluence with format conversion and approval gate","platform":"Claude","tags":[],"authorName":"LLM Mart","authorSlug":"llm-mart","score":0,"source":"github","price":null,"verified":false,"createdAt":"2026-09-28T15:11:44.184473Z","repo":{"url":"https://github.com/huytieu/COG-second-brain","stars":1236,"forks":147,"license":"MIT","updatedAt":"2026-09-28T08:52:07Z"},"bodyHtml":"
\n

name: publish-to-confluence\ndescription: Publish any markdown file from the vault to Confluence with format conversion and approval gate\nroles: [product-manager, engineering-lead, founder]\nintegrations: [confluence]

\n

COG Publish to Confluence Skill

\n

When to Invoke

\n\n

Agent Mode Awareness

\n

Check agent_mode in 00-inbox/MY-PROFILE.md frontmatter:

\n\n

Command: /publish-to-confluence

\n

Pre-Flight Check

\n
    \n

  1. Read 00-inbox/MY-INTEGRATIONS.md — Confluence MUST be listed under Active Integrations

    \n\n
    2. \n

  2. Get current timestamp: Run date '+%Y-%m-%d %H:%M' using Bash

    \n
    3. \n
\n
\n

Execution Strategy

\n

Phase 1: Identify the Source Document

\n

Determine what to publish:

\n

Option A: User specifies a file path

\n
Read the specified file from the vault.\n
\n

Option B: User describes the document

\n
Search for matching files:\n1. Glob for likely matches in 04-projects/, 05-knowledge/, 01-daily/\n2. Present candidates and let user choose\n
\n

Option C: Just-generated document\nIf this skill is invoked right after generating a PRD, release notes, or other document, use that document.

\n

Phase 2: Configure Publishing Target

\n

Ask the user (if not already provided):

\n
Where should this be published in Confluence?\n\nRequired:\n- Space key: [CUSTOMIZE: YOUR-SPACE-KEY] (or let me search for spaces)\n- Parent page: [Page title or ID under which to nest this page]\n\nOptional:\n- Page title: [defaults to the document's H1 heading]\n- Labels: [Confluence labels to add]\n- Publish mode: \"create new\" or \"update existing\"\n
\n

If the user doesn't know the space or parent page:

\n
Use WebFetch to search Confluence:\nGET /wiki/rest/api/space?limit=50\n- List available spaces for the user to choose\n\nGET /wiki/rest/api/content?spaceKey=[SPACE]&type=page&limit=25\n- List pages in the space for parent page selection\n
\n

Phase 3: Convert Markdown to Confluence Format

\n

Convert the markdown document to Confluence storage format (XHTML):

\n

Conversion rules:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
MarkdownConfluence Storage Format
# Heading<h1>Heading</h1>
## Heading<h2>Heading</h2>
**bold**<strong>bold</strong>
*italic*<em>italic</em>
- list item<ul><li>list item</li></ul>
1. list item<ol><li>list item</li></ol>
[text](url)<a href=\"url\">text</a>
`code`<code>code</code>
Code blocks<ac:structured-macro ac:name=\"code\"><ac:plain-text-body><![CDATA[...]]></ac:plain-text-body></ac:structured-macro>
Tables<table><tbody><tr><th>...</th></tr><tr><td>...</td></tr></tbody></table>
> blockquote<blockquote><p>quote</p></blockquote>
---<hr />
- [ ] task<ac:task-list><ac:task><ac:task-status>incomplete</ac:task-status><ac:task-body>task</ac:task-body></ac:task></ac:task-list>
- [x] taskSame with complete status
YAML frontmatterStrip entirely (not displayed in Confluence)
\n

Important conversion notes:

\n\n

Phase 4: Preview and Approval Gate

\n

CRITICAL: NEVER publish without explicit user approval.

\n

Present a summary to the user:

\n
Ready to publish to Confluence:\n\nDocument: [filename]\nTitle: [page title]\nSpace: [space key]\nParent Page: [parent page title]\nMode: [create new / update existing]\nLabels: [labels]\n\nContent preview (first 500 chars):\n[preview text]\n\nEstimated page size: [approximate word count]\n\nProceed with publishing? (yes/no)\n
\n

Wait for explicit \"yes\" before proceeding.

\n

Phase 5: Publish

\n

Create New Page

\n
Use WebFetch to POST to Confluence REST API:\n\nPOST [CUSTOMIZE: your-confluence-url]/wiki/rest/api/content\n\nHeaders:\n  Content-Type: application/json\n  Authorization: [from configured credentials]\n\nBody:\n{\n  \"type\": \"page\",\n  \"title\": \"[page title]\",\n  \"space\": { \"key\": \"[SPACE_KEY]\" },\n  \"ancestors\": [{ \"id\": \"[PARENT_PAGE_ID]\" }],\n  \"body\": {\n    \"storage\": {\n      \"value\": \"[converted XHTML content]\",\n      \"representation\": \"storage\"\n    }\n  },\n  \"metadata\": {\n    \"labels\": [\n      { \"prefix\": \"global\", \"name\": \"[label]\" }\n    ]\n  }\n}\n
\n

Update Existing Page

\n
First, get the current page to obtain the version number:\nGET [CUSTOMIZE: your-confluence-url]/wiki/rest/api/content/[PAGE_ID]?expand=version\n\nThen update:\nPUT [CUSTOMIZE: your-confluence-url]/wiki/rest/api/content/[PAGE_ID]\n\nBody:\n{\n  \"type\": \"page\",\n  \"title\": \"[page title]\",\n  \"version\": { \"number\": [current_version + 1] },\n  \"body\": {\n    \"storage\": {\n      \"value\": \"[converted XHTML content]\",\n      \"representation\": \"storage\"\n    }\n  }\n}\n
\n

Phase 6: Confirm and Update Vault

\n

After successful publishing:

\n
    \n

  1. Confirm to the user:

    \n
    Published successfully!\n\nPage: [Title]\nURL: [Confluence page URL]\nSpace: [Space Key]\nVersion: [version number]\n
    \n
    2. \n

  2. Update the source vault file (add published metadata to frontmatter):

    \n
    confluence_url: \"[page URL]\"\nconfluence_page_id: \"[page ID]\"\nconfluence_space: \"[space key]\"\npublished_at: \"[timestamp]\"\nconfluence_version: [version number]\n
    \n
    3. \n

  3. Log the publication for future reference.

    \n
    4. \n
\n
\n

Re-Publishing (Update Flow)

\n

If the vault file already has confluence_page_id in its frontmatter:

\n
This document was previously published to Confluence:\n  URL: [confluence_url]\n  Last published: [published_at]\n\nWould you like to:\na) Update the existing Confluence page (increment version)\nb) Create a new page (separate copy)\nc) Cancel\n
\n
\n

Fallback Behavior

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
ScenarioBehavior
Confluence not activeStop and inform user; suggest alternative platforms
Confluence API failsSave the converted XHTML to a file so user can manually paste it
Authentication failureInform user their Confluence credentials may need refreshing
Page already exists (same title)Ask user: update existing, create with different title, or cancel
Very large documentWarn user about page size; suggest splitting into child pages
Complex markdown (unsupported elements)Convert best-effort, warn about any elements that couldn't be converted
\n

Error Handling

\n\n","files":[{"path":"SKILL.md","sizeBytes":7761,"isText":true}],"reviewScore":null,"reviewSummary":null,"trust":{"provenance":"trusted-source-unreviewed","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow.","bodySource":null},"bodyLocked":false,"purchaseUrl":null,"sourceUrl":null,"report":{"provenance":"trusted-source-unreviewed","screen":{"ran":true,"outcome":"clean","suspicious":0,"notes":0,"hiddenCharacters":false},"virusScan":{"engine":"clamav","status":"clean","scannedAt":"2026-09-28T15:13:58.427715Z","sha256":"80732E9EA2A704B77F1BA33CDD48C227B76DF1802CBD3401944A802C6E924E28","sizeBytes":3494},"review":null,"source":{"repositoryUrl":"https://github.com/huytieu/COG-second-brain","path":".claude/skills/publish-to-confluence","license":"MIT","commit":"4cdb6015dc6eb66f74bac513856ff6446ecb5d1b","subtreeSha":"C1D1E9445F483337A37FA20D67ED824FFA339E2B4C1181CB5CE061A11732D749","lastSyncedAt":"2026-09-28T15:11:28.148164Z"},"reviewedAt":"2026-09-28T15:17:47.017549Z","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow."},"install":[{"target":"skills-cli","command":"npx skills add https://github.com/huytieu/COG-second-brain/tree/main/.claude/skills/publish-to-confluence"},{"target":"claude-code","command":"claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install huytieu-cog-second-brain@llmmart"},{"target":"git","command":"git clone https://github.com/huytieu/COG-second-brain.git"}]}