Confluence Skill

Critical Rules

DO NOT use MCP for page uploads — size limit ~10-20KB. Use upload_confluence.py instead.
DO NOT use MCP for structural modifications — AI tool delays cause 650x slowdown (~13min vs ~1s). Use REST API scripts.
DO NOT create temporary analysis scripts (/tmp/analyze_*.py). Use existing analyze_page.py.
DO NOT write inline scripts to manipulate ADF JSON — use the structural scripts which handle ADF marks correctly.
DO NOT use raw XML/HTML for images. Use markdown syntax: ![alt](path.png).
DO NOT forget diagram conversion — pre-convert Mermaid/PlantUML to PNG/SVG before upload.
MCP is fine for reading pages and simple text edits (Method 6).