What problem does it solve? Updating existing Confluence pages through the MCP updateConfluencePage tool replaces the entire page body, which silently overwrites edits made by other people (including editor Autosave) and blows past token limits on pages over 50k characters. This Skill performs partial, diff-based edits through the Confluence REST v2 API using the native Atlas Document Format (ADF), so only the intended sections change. ## Core Features & Use Cases - Diff-based ADF editing: Replace text, drop sections or paragraphs, swap tables, add rows, and insert nodes with count-checked operations that stop when the expected match count is wrong. - OAuth token reuse: Reuses the Atlassian OAuth access token already stored in macOS Keychain by the MCP connection, with an API-token fallback path for environments without MCP. - Safe update protocol: Re-fetches the page version and title immediately before the PUT to avoid clobbering concurrent edits, then verifies changes by diffing storage-format dumps of old and new versions. - Use Case: A teammate asks you to add a row to a status table and fix one figure on a 60k-character Confluence page. You fetch the page as ADF, apply targeted edits with adf_edit.py, PUT only the changed document, and diff versions to confirm nothing else moved. ## Quick Start Update the Confluence page with ID 123456 by replacing the text "actual 12 items" with "actual 18 items" using a diff-based ADF edit instead of a full-body replacement.
