confluencelisted

## When to Use Use this skill when: - User wants to read or search Confluence pages - User wants to update a page (e.g., add release notes, fix grammar, restructure content) - User wants to create a new page in a Confluence space - User wants to address, reply to, or act on comments left on a page - User references a Confluence URL (`your-org.atlassian.net/wiki`) ## Prerequisites - `hurl` installed: `brew install hurl` - `jq` installed: `brew install jq` - Credentials file set up: see `README.md` - `<SKILLS_DIR>`: the root skills directory (e.g., `~/.config/opencode/skills/` for opencode, `~/.claude/skills/` for claude-code) ## Core Safety Principles - **Fetch before modifying.** Always read the current page content and capture the version number before any update. Confluence requires the current version to prevent conflicts. - **Show before writing.** Display proposed content for approval. Confluence has no built-in undo for API writes. - **Never write without explicit approval.** Create, update, and reply operations must be approved by the user before executing. - **Check for existing replies** before proposing a reply to a comment thread to avoid duplicates. - **Do not resolve or delete comments** unless the user explicitly requests it. ## Workflow ### Step 1: Confirm credentials ```bash [[ -f ~/.config/hurl/confluence/default.env ]] && echo "ok" || echo "credentials file not found: ~/.config/hurl/confluence/default.env" ``` If missing, stop and guide the user to