mk:confluence-page

Confluence page CRUD via the confluence-as wrapper. Triggers: 'create page in SPACE', 'show me page 12345', 'update title of page 12345', 'delete page 12345', 'page hierarchy under 12345', 'copy page

SKILL.md

GitHub

mk:confluence-page

Forks to the confluence-page agent (system prompt at .claude/agents/confluence-page.md). The skill body is the task brief — the host runtime injects this content into the forked agent.

Triggers

  • "create a page in SPACE titled '...'"
  • "show me / get / view page 12345"
  • "update title / body of page 12345"
  • "delete page 12345"
  • "list children / ancestors / descendants of page 12345"
  • "copy / move page 12345 to SPACE"

Examples

  • Quick create: "create a page in ENG titled 'Q3 Roadmap' with body from /tmp/draft.md"
  • Templated create: "create an RFC page in ENG from the rfc template"
  • Read with projection: "show me page 12345 in storage format"
  • Update: "set title to 'Q3 Roadmap (final)' on page 12345"
  • Hierarchy: "list children of page 12345 with depth 2"

See also

  • Agent: ../../agents/confluence-page.md
  • Shared: ../confluence/references/{install-and-auth,cli-idioms,safety-framework}.md
  • Domain refs:
    • references/page-templates.md — RFC / Runbook / Decision Record skeletons
    • references/field-formats.md — storage / view / export_view / ADF distinctions
    • references/version-restore-guide.md — version operations + restore semantics
  • Peer leaves: mk:confluence-search (CQL search + space list), mk:confluence-collaborate (comments / attachments / labels), mk:confluence-bulk (10+ pages), mk:confluence-spec-analyst (spec analysis)

Gotchas

  • Wrapper output is JSON only after the stdout filter runs. Do not parse raw confluence-as output — always go through the wrapper. [from research]
  • POST is in confluence-as retry allowed_methods. Create ops on flaky networks may produce duplicate pages. Before retrying a failed page create, list pages with the same title in the target space first. [from research]
  • ADF round-trip is lossy on panel, expand, mention, emoji, media, decision, task-list nodes. Re-saving a page with these macros via update may flatten them. See references/field-formats.md Round-Trip Caveats. [from research]
  • XHTML parsing in confluence-as is regex-based. Malformed or deeply nested storage format may fail silently. Prefer markdown via --content for fresh page bodies. [from research]
  • version restore creates a NEW version on top of head — it is not in-place rollback. See references/version-restore-guide.md. [from research]
  • Grow this list as new edge cases surface.