confluence-publish

What This Skill Does

The Confluence Publish skill provides a robust bridge between local content generation and enterprise documentation management. It utilizes the Atlassian Confluence REST API to automate the lifecycle of wiki pages. By interpreting HTML content, the agent can either initialize new pages or perform intelligent 'upserts' to existing pages based on a provided title. The skill is designed to handle metadata extraction directly from HTML comments, allowing for seamless integration with AI-generated documentation workflows. Whether you are synchronizing engineering logs, meeting notes, or project specifications, this skill ensures your documentation remains current without manual intervention.

Installation

To integrate this skill into your environment, use the OpenClaw CLI to fetch it directly from the repository: clawhub install openclaw/skills/skills/aeincx/confluence-publish Ensure your local environment is configured with the necessary access permissions to the workspace directories where local file paths might be referenced.

Use Cases

1. Automated Documentation: Automatically publish code documentation generated by an LLM directly into a team's Confluence space.
2. Meeting Minute Sync: Capture structured HTML output from a summarization agent and post it to a specific parent page ID, keeping project updates organized.
3. CI/CD Integration: Incorporate project status reports or build results into a tracking page on Confluence as part of an automated reporting pipeline.

Example Prompts

1. "Publish the content in summary.html to the 'Engineering' space as a page titled 'Q3 Project Review' using my saved environment variables."
2. "Update the page titled 'Technical Architecture' in Confluence with this new HTML block: <h1>Architecture v2</h1><p>Updated schema details...</p>."
3. "Check if my Confluence credentials are configured correctly by running a connection test."

Tips & Limitations

• Security: The skill strictly validates that env_file and page_path reside within the workspace to prevent unauthorized file access. Always ensure your Atlassian API tokens are scoped correctly.
• Metadata: Using the metadata comment format is the most efficient way to manage parent-child hierarchies. Always verify that your space_key and parent_page_id are correct before execution.
• Content: While it handles standard HTML, ensure your CSS is inline or standard for Confluence to render correctly. Complex JavaScript or custom CSS frameworks may be stripped by Confluence's internal filters.