confcli

What This Skill Does

The confcli skill is a powerful command-line interface tool designed to bridge the gap between your local terminal and your Atlassian Confluence Cloud workspace. It allows you to programmatically manage your documentation by reading page content, searching for specific information across spaces, and performing complex management tasks like handling attachments, page hierarchies, and metadata directly through your AI agent.

Installation

To enable this skill, run the installation command provided by OpenClaw: clawhub install openclaw/skills/skills/hochej/confluence-cli. Once installed, ensure you verify the connection by checking your status with confcli auth status. If you are not authenticated, you can run confcli auth login or export your Confluence API credentials as environment variables (CONFLUENCE_DOMAIN, CONFLUENCE_EMAIL, CONFLUENCE_TOKEN). Always ensure your API tokens are handled securely via environment variables rather than hardcoding them into scripts.

Use Cases

This skill is perfect for automating repetitive documentation tasks. You can use it to list all pages in a specific project space, export page content to markdown for offline review, or quickly find a specific document using complex search queries. It is particularly useful for developers who want to update technical documentation directly from their command line or for teams that need to perform batch operations on page labels and attachments without navigating the web UI.

Example Prompts

1. "Search for all pages in the Engineering space that contain the word 'architecture' and list their IDs."
2. "Get the content of the 'System Specs' page in the PROJECT space and export it to a local markdown file."
3. "Upload the file 'diagram.png' as an attachment to the page with ID 98765."

Tips & Limitations

Always exercise caution when performing write operations like delete, update, or copy-tree. These actions modify your company's knowledge base. Use the --dry-run flag whenever possible to see what will happen before finalizing a destructive command. Be aware that page references can be handled by ID, URL, or the 'Space:Title' format. If you find yourself frequently working with a specific space, keeping it as an environment variable can help streamline your workflow. Finally, remember that this tool requires internet connectivity to communicate with Atlassian's servers, so it will not work in air-gapped environments.